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Tlie Apple II Reference ?1anual contains a (Complete assembly listirif^ of 
nil'- rionftor pro(^rain in the Apple TI. The Apple II Monitors Peeled 
M,inii:il (thiii book) conta<n'; Hpsc ript ions of the vari.'>us routines in 

flu' fVjn i tor aad address tables arr ^in^cd by top ic Ins Lead of ir the 
Hoquence of location within the machines- The material you flncJ here 

M;*ny tif the CALLable points in tbe flonitor fall undet nwre than one 
topic- The layoyt of this boott Is intended to rolnlTnlEe the 

tii"-^ 



This dociiinen.j covers the Apple TI Monitor (both tho Old Monitor and 
the dVutOstart Monitor versions), ROM address range $F^0fA-^FYFY . ThiM 




Til ere are two Monitor KOM's available fQa^^^^e. 
H^mt^t^i'^ are identical for most functii^^. 




e II. The two 
^IffeC only in certain 
ii>}dl cations ^jrov.idal 



J^dTie thousands £jf Apple TI computers 'havfi been shipped with the 
I'nrller version of the Monitor, In this book, that will be referred 
f [1 Hit the Old Monitor- In 1979, a new version of the Apple II Monitor 

war: developed. This Monitor contains new features to facllitEitc systein 

Htart-up and program editlnjf^ at the expense of removini^ the 

I t riitrt Ion trace and single step facilities and sixteen bit multiply- 

dlvlde roi.LLlne of the Old Monitor, This new Monitor is called the 
All! ostart Monitor in this book. The. Autostart Monitor is available 
Iron Apple Computer Inc. and from many tomputer dealers tinder the 

njme Autostart ROM, Apple Part No- 

Ic ^S; e^?^ to determine which Monitor Ig In a i^a<^*ti-3m* If the machloE' 

•:t^^:'i^:m^-m-^^^'^t4^ the top g\.mmmm^^m 



■.'CiOntains the A«t:cfefc^t' \ 



A prui^r.iTii c;in also 
Aiif'^sL,iil \m. The byte ac $FAF 
Anioatart and $^1 in the Old Montc^;^^ 



determine wheth^:^^^^ ^i^^^^fs 
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Us£i of Tsienory by the Monitor and by the Apple II for mni^lilm- 



S^^^MM^ion In detai] of all nemory locations in page zero iMpA 

% Monitor, indicating legal range of values and all roUttn» 

which use the location- 
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Ways and m^m-.m^..^^€^m if^J^t^cii as a formatted :i 
device, wlt'fcl nMT ^i^ii^iEtttfc gart screeii ^etng 
Scroll Windc^v, 
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OF INTERREJPT 
General and speclfi^fe^ 

procee&lng with regard 
in particular. 



^ion of interrupts and Inlerrupt 
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allowing user call to subeets. 
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IRQ/BRK INTERRUPT HAHDLIHG 

Descriptions of handling these. ^t^^. 

flonttots. With Address Tabled* 
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Address table f^r rovitlTies ttit? Hqultpr \^lch can be cjilli'tl tx> 



!^E&&^^^^tloiis of Che routlRes in the Monitor whirh snjij^orf llitA^ 
fatictloti, with a table of addresses for directly calliria Lhunu 



■'li^SNIPULATIOK FUNCTIONS 

■J^^cription of the routines In the Motiitpx 
wl^tli regard to '^^l 



:®N110R COMMAND PROCESSOR 
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Monitor commands and return to caller -^^flLJ^Ig, Jl^^te*.. 

SPEAKER (BELL) iJSE THRCUCH TIIE MONITOR 



Description of all the routines Ijwolved with reading or writlnf^ 
of tape. With user call Information apecifJed for the high level 

routines. Includes list of r.allinf^ programs for each point. 

"Saddles, buttons, atjd ahnunciator i/o 

Description of paddle reading for the machine language progratnmiT 
and address^' ^ liS© fer;- S^- th^e ,^?tevfee^v* 

WAIT ftOUTItJE 

This rautint? will take control of the machine for a lenp.th c^f"- 

time depending upon tbe input A-reg value. Table and formu! 

provided for use ^ere dntexval between events Is critical- 




itEGlSTERS FOR BASIC MONITOR CALLS 

The Monitor CO command routine makes it posslhlc to call from 
BASIC most ffonitor routines which receive input in rep^isLcrs. 

^&ECIHAJ- TO REX COWERSIOT'J 

A sample proj^ram that shows how Co convert from decimdl t*> 
hexadeoirnal . 



STEP AND TTUCK PECJJLXARXTIR.S 
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MEMORY ALLOCATION 



MONITOR USAGE MEMORY MAP 

'^Mocy. Is dlvAded- iuto 25Si. bj^;.e -s.et^ti^tns^ ^neral-ly. r.Bf^<e;Emi m> ^ 

ft^fdi'eRB of a byte in page zero my be expressed in a b^^V 
ll^&rif processor inscruc-.tions are only two byte^ i^i^fi^ 

the operandi la in page aero. Thus, Monitor usage of page Zero 
t^^^ives heavy treatment in the following seotion- 

Pase one (address range $0100-$01FP) is also special in tlie Apple II. 
Hits entire 256 byte aiea is called the "stack". The stack is a 
tomporsry storage area for wlUch special Instructions are provided in 
tho ft.^i;J2, The contents of thp. A-re^ster or P-ireglsLer may be puahe<^ 

sveim^: ms^ m'- tfe^ iJ©c^i'Mt eitr^e^i-y $p^^Mm^ %y 

S-refilster: then thfe S-re^lster Is d^c_femented- Data my be tctlled ot 
popped from the Htack;^ i*lch rneans that tbe S-reglster Is 
Incremented, and then the hyte pointed at by the S-re^ister is picked 
up into the appropriate register- A JSR instniction causes the 
current concents of the Pi-oj;ram Counter to be pushed onto the stack 
hcFore the jump. An RTS instruction pulls two hytes from the stack 
into the Program Counter. 

The >toitor contains instructions whicii use the stack, t^te, 



PrtRp two (addtefis range 
keyboard i^^TJAjt area* The 




the Apple II as tilse. 

ttf4 ^ te Mas 



Kdj^e three is address rangs S030&*--S03FF . Moat of this area is unused 
f^, the Monitor. Quite often the first 2^0 or so hytes are used for 

machine language programs called by APPIESOFT or BASIC programs. The 

Monitor uses onl^; *^ -^Ni:^-*: ■^i^'^^^^^^' ^ r^^^- 

Address T^.ble. S^^fe, ^5^?^®fc^ "St^ s^^ES ^^Bs-"^ .^g^^^.ig^^f^ 



I'-j^'ivi four through seven comprise the pp^^tE^^^ '^fext or color ^rapbil^ 
fllspljiy area. Pages eight thru eleven Ki^^pS&fe tbe secOnd^^^ ^tti>Et 

^toibr g^^phlcs dlspla.^: -^t^ -^m -ie^^e fhe « 
-ii^^'-, _jioMever, page ^ llrst .p^^a^. 

^^ma.'* %i th^ add'F6&s^ ^^tee^. ■K^?;^- at^ 




From address $0800 to the end mpmory In the Tnachlne is the user 
area for proj^ranis and data. However, if High Resolution Graphics Is 
in use, then memory area from $2000 through $3FF^^ '^^f^ l^^i^a^^ 



display area tot th.i t tunctioa snd S4000 through 
the secondary display area for that fuactioQ- 





0?f0ft l^B^ -.^y^: 

00FF 1 


0100 fStja^fc 

01FF 1 




lAvallable. 

1 

03D0 
03EF f 

03F0 1 Vectors 
03FF 1 


0400 [Frlmnry TeKt 
07FF land LORES Area 


0600 Ulser Program 

1 and Dat*i space 
|to RAM sizo. 

^|ROM APPI3SQFT 

2000 1 

2FFF IBi^mm 
1 

3FFF 1 
1 

A000 f 
1 

^ i 




Rm APPLESOFT 
COMPILER/ 








RAtl APPl^^t 






■ ... 

I 

mm -m^m 







PAGE ZERO 



The Monitor makes use of tht? pii^^o 7ero locations from 32 ($20) throni^h 
73 fS49) for general functions and normal oper^cltjTTs, Locations 74-77 
C$4a-'iD) aCe not tonched by ^its liJftt^fcEQ^* l^^X^m ^ 
modified as described below scft 
EoE an ^ippllcation program. 





The Autostart Monitor uses locations and 1 during system 
initialization- This initialization is described In the section on 

"'W^M^ .Jj^tera^t^. - ^^y^^is^^t; -^mi-t^r"^' •md^-'hm^m ^©F^ri^^to ^^^-^^S 

o£ WaC^^'-^ 1.*. 




0^ 



S01 



LOC0 
LOCI 



These loc.Uions arc used by the Autost^irt "lonitor 

during the automatic Disk Rootstrap function which 
takes place when the computer is powered up- Usir^- 
these locations for Indirect addressinp,, the sl^^ 
addresaeii are checked - from slot 7 down thru 
I. determine presence of a dlst ^i.. 

i£- ts''^tind, a Jump Indirect viol 



tange Is I? f-Q 39 (S27). 

This field Is used only In. VTAPZ wliich set^: 
to the memory location correspondinji to CV antJ 
WNDLFT. The contents, uhen chanj^cd l:y user 
program, become effective on the next scroll 
operation, clear to end of page operation, or 





After changing the cooce[?^1*v 
VTA3 or print a carriage 
Ciake it take effect.- 



% i Jt^ 40-(WOLFT), 

^^igacter is written through COUT to the 
screctv it is placed at ( RASL ) , ( Cll) , after which CH 
is incremented. Then (CEl) is compared with 
CWH])WDT!1) CO determine whether tbp cursor has 
exceeded the rij*ht margin of the Scroll Windnw. 
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Hcc Ilex Monitor 

Add r Add r L cibel Descri ji tlun 



34 $^2 WNDTOP 



Top line of Che Scroll Window; 

^■^■^M pa4:u^.^ ^-i^'Wm^ in Basics are ^1, 22, '5^* 

^^^■^i'^ ■mrij\S!. a scroll operation 

^T^iica^ the lirie on vhich the operation shouM 

It is also the line on v?hlch Che cursor La 
placed on completion of a HOME cperation (clear 
the window, place cursor at tor lefc). 

Nonjlnslly, bottom Hire of Scroll Window; 
RariRe Is CWNDTOP)+J to 2i . 

WNDBTTT contains Lhc nLimher of the: first line 1 ow 
Che Scroll Window* ContenCS of VNDBTM are tesCed 
only on outpoE ^^t^ri'^ti! ^^■^.--^-Mvm 
reed (58A) . Eti't^'^:^ W^m-m « fe'^^'^ncf 

hy iicroll rofJtines- 

rrom UNHLFT whore ne>tt chm^M""^ 

. ,^ . Ranpe is tO 

- I* fecreen output routine 

""-pS'^t^'^ ^•-^t^^SfG^&.-e into che screen area as 
C)f normal c^Tiaracter ouLput , ClT is then 
j^ffereFiented and coiapared to t.tjrivOTH- If CH la not 
less than WNITWDTII, ^ carriage return will be 
simul atcd ■ 





37 $23 



Mote that CH in used Tor ecboi nji keyboard input to 
tha screen by the Honit.jr CPTLN etc. mntlnt^ft. 

Vertical screen position (lino number) for next 

character: to be written to the atreen: Ka^ige is 
to "3 (S17). The content CV Is relative to th^ 
top Of the screen^ noc to the- top of the E^croll 
Wfrrdow. It may be set by loading the desTted line 
minber into A-rej> and callinp; TAhV, It my be ^^cf 
by POKKlnf^ the Htig niiinl>er into CV and then 
calling VTAR< Actual stora;^e of a rhara-cter Into 

the fscreen ^irea includes use of TiASl.,H for line 
minber, not CV, The calls atewe^ ^.:■May^■^^,T■ ^A*W 

are to se; TIASL^H from CV (at^ Wg^^ 
iimediate f iit nrt: re To re nee • 



If CVis at o*- below i/MDRri it will remain on th.' 
current screen line as carriage returns ^o by 



Dec Hex tlunit(^i! 



^femory address within the screen area Of the left 
^nd point of the desired line for LORES plot. This 
^ield is sec by the GBASCALC routine to t?ie memory 

This tvo byte field is Che ritemory address for the 
left end character position of the current text line, 
line, within Che Scroll Window. Tht coatertta ar^ a 
function of CV and WNDLFT. 

This field is set by the BASCALC routine to point 
to the nemory address for the left end of the 
screen line Specified In the A-reg. This call to 
BASCALC is usually accomplished by Lhe VTAB 
routine, which then adds (WNDLFT) to BASL,H to 
point to the left end of the line within the 
Scroll Window, 

This two byte field is used as a work ares only 
during a scroll operation., ^-•'l^ 
line pointer used as eacb.-lj^^ ' " 

position above di^^fi?^^* 

4^ m m iigbt end poirt^ ^-^^^^^ m^^rn^ 

■tile HLINE routl^:, to 39 (527). 

mis l^te is set W '^y^^' calling proj^^^^m before 

WSffl tbV TipJ-Ce of two byte pointer (LtttJGH, RMNm) used 
liy Disassembler ,is index to mnemonics t;ible, 

* Save area used by the Instruction Trace routine 

of the Old rionltor- 

Bottom point of a vertical Uhq Mjsg dravn by 
VLINF. routine; Ran^^e is 'M ^^'&^) for mlxp^ 
screen, & to 47 t$2F) for ^3 -b<^&^j^ grapMcS. 
This l^^te TmiGj ^ ^et, ^fore VLIM Ifi called- lim% 

'^^M^M^ ^^Ti the Clear Screen 

*GI^^ S^^^i^ CO dear the soree^^ 

^ ^ed with DlNKM as t^^^ %e "^^^ 

the Disassembler. 

^^'^ 8W Used with RTNL as a save area by the l^^itk^^^ 

Trace routine of Che aid Monitor. 



^2 $2A BA52L 
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Addr Addr Label DeacripcloT] 



46 S2E 



With this label, this locatlQii^^i^^ as a S^F 

Hsin^ this label, the Dlsasserabler uses this 
as temporary stor3j»e for the code which indl. ~^ """" 
the format of the Instruction for display 
pur; 



4| $^f^ 



IS 



This byte Is used during cassette tape read 

'fetJitEtlnually accutriulate Che cbecl^smn ijl^lch 

Jfcfe compared to that generated during the urlf^ 
^^;*eration which created the record* This byte 

-:t-;^ltial iaed Co zero at the beglnniTig of a tape 

read- As each byte Is stored Into memory in is 

Exclusively URed apalnst UUKKUM, After the last 

byte has been stored, one more Ijyte Is rcarl from 

the tape 3Tid compared to CETKSUfU If equal, a good 
read nay be assumed. As this result Is not £4^1^-^^ 

stored back Into CUKS™, that field cannot ^< ^tisM 

by the calling program to determine g^^c^igH^; ®^ 

failure of tbe read- A method iStfe, 

determination will be found Iti 





clianged. 



This field is set by the Disassembler to indicate 
the length of the in 3 C rue t ion p After output of the 
dlsasseiabled instruction, ?CAEJ uses this val^ 
compute nev values for PCl.,il, which are retus';§^ 
to caller in the A and ¥ reg for user stora^fe' tO' 




life 



ter 3 call to TIIJLPN or DIVPH (signed Ui hi4-_ 

tlply or divide in the Did Monitor), the ^1 
1^ .of this byte Is set if the. always-poslt^.^^ 
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Dec Ilex Monitor 

Addr Ad d r Label DeEcrlptlon 



48 S3t^ COLOR Thla byte contains the cpde for the color of 

points to be placed on the screen in graphics 
^lode. The RETCOL routine Is entered ^dth a value 
-iti the low order four bits of the A-reg • This 
value Is then plac(?d in both the hl^h and low 
nibbles of COLOR- COLOR la then used with ftARK in 
setting the va W ^_ to ^^^^^^^ 

to accomplish S ^ip^Et^mi.l^ .pamt -'^a 

selected color* 



Color can be set directly by stufffng th^.^ 
multiplied by $11 in coIqe., .^^i^^j^i^^ 




5*17, 



This byte is used hy the Ifonltor command 
processing routines to control parsing and to 
coritrol operations when a blank is encountered 
after the hex digits. For example, a hex address 
followed by a colon causes setting of fDDE so that 
during further processin^^ of the input line each 
blank encountered signifies end of a hex value to 
he placed in memot)'. During parsing, the c^ntent^ 



plus. n4¥^-, ^^m^ji ^ '^it^M.' ' 



-This byte is a mask used by COUTl to cause 
^i^haracterfi written to the screen area to display- 
white on black (INVFLG=SFF) or black on white 

(If:VFLG=S3F) or bllnkln^^ CINVFLG=$7F) . This fi&M 
is set to $FF when a RESET occurs by the routine 
at SETHORtt. The routine called SKHNV can be 




"S^i^ b^^e character which is 

W^t^n hi -$\m -m^et^. fe' ttonltor GKTLK routine 

^l^^l/^: line of characters 
fcfr^-' , .#;fe^^-tte'RKSET Icey Js pressed, 
-.^^441 '^mfeor- .-enters the MOM routine, at 
,^ieh point th6 PROMPT field is ser to $AA, 
4he AntoBtart Monitor also sets the prompt 
-^Hp^^ir^^Jer th^ ^e)Jl xputlne, but tbla la iioL 
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Dec Hex Monitor 
Addr Addr Label 



Description 



52 $34 YSAV 



This byte is a save area used by the lionitor 

Proceasor- The Y-reg Is used by the 

Connnatwi Processor In Indexing through the input 

illne-i. yiieti a corriffiatid has been decoded, the Y-reg Ig 
^miJ^ '^t -'iSKV before' going to if^jee^Ji^ 

qa ret«r^ t9 the cpmm^^^^ m 



line. 



This byte is a save area for the Y-reg across a 
call to the screen output routines, Y-reg is saved 
and restored in the COUTl routine. 



54 S3 6 CSWL 



This two byte field contains the address of the 
routine i^fliich Is to receive and dispose of output 

characters- \Jhe:n the RESET key Is pressed this 
iield is initialized to point to COUTl to send 
^witput characters Co the screen* Entering a 
monitor Comniand nPc CTi=port number, Pc°control^P) 
will cause the Honitor to set CSWL to CSWIT to 

Cn- The routine at that location will then receive 

(in the A-reg) each byte ''written" through COUT^ 
which Is a JHP (CSWL), 



If the Monitor CoTumand "0Pc"' is executed, CSWL,H 
is set to point to COUTl instead of to ce^^l?. 



56 338 KSWL 



This two^ £i^J^,e«if^t^3.±AS the address of Che 

u*?er inpufi ^©^ififei^^. 4fe SESET key 

proceSsl^ ^^. -1^ IgK^^' i^^ gets Its input 

■^^tti^e^f.^ ;%^i^^t»Jl^ip(' i^;^. m^tin^ of KSWL 
to KM to til. This t^iut&e' them called any 
time the Monitor or executing program aaks 
another byte of input by calling RDKEY or ^ 
the routines which in turn calls RDKEY- 



The Monitor Command 'Wc" results in setting 
KSWL.H to point to KEYIH instead of to C^00, 



58 ?3A PCL 

# #^ m. 



gi^I^ .S?^^. save and control area for the 



When a BRK Instruction is executed, this field Is 
set indicate the address stacked by the 65(J2, 



Iirr Hex Monitor 

Md^r Addr Label DescrlptiQn 



This field is used during Monitor COToffiands L and G 

^ Monitor "GOTO"). Durt^, 
Eductions tbis field iff. 



command. 




Updating of this field is accomplished with the 
assistance of the PCADJ routine i^enever -ise 
requires inc r^Tnent ing in accordance with the 

length of the instruct i ons • (See LENGTH at 47 or 
$2F-) On return from PCABJ, store A to PCL and Y 

to PCH to accomplteb update. 

This field is used by the Old Monitor in support 
of Monitor commands S and T (single instruction 
ste^ an4 Instruction trace)* For tho^e function?,, 



53C XQT 

XQTNZ 
(>l-6/ $3D-$A3 



64 m^. Mt- 



This field is used as a work area for instruction 
step and trace in the Old Monitor. Tlie tteld is 

eight bytes long and overlays A1L,H; A2L,H; A3L,H; 
and A4L,H- The nex:t instruction to be exft^jH^ig^ 
(Indicated by the contents of PCL.H) is moffl^ 

this field, jipssil^lj; ricdlfled .depe^^ 



Jlultlpurpose Ifonitor wo^^t^ 

May be clobbered by Instruction trace In 

the Old Monitor; see XQT above. 

When the Monitor begins processing a command, MODK 

is initialized to zoro. As tlie input line is 
scanned, hex digits are first placed into A2L,1T. 
Frotn there they are moved also to AIL ,H and A3L,H 
as long as JIODE remains zero- When a plus, mlT^ 
colon, or period is encountered, MODE Is modif; 
-tj© -in^^^tiSj i-feich, and AIL^H will e^tinue to 




AlL,H is the primary Index for the 
command, memory examine or dlsplajf.^ 



Dec Hex Monitor 

Addr Addr Label Description 



AlLjH contains the minuend for the Monitor 
SUBTRACT command- 

A1L,H Is the source field pointer during the 
Monitor TDVE command, 

A1L,H the source field froisi which PCL,H is set 
OTT I. and C Monitor coiTimandg , and the Old Monitor 
commands S and if an address Is specified* 11 
no .-iddress Is used in 06; 5^^^ -'k^^ tMm. fe^*-^ 
Is the residue of the 
cialntalned or used It. 



AlL,H is the ireniory pointer used f^jF ^^^i*^^^ vtt^: 
flt^ Wa^tTB Monitor operations, 

ifec^^^fr- *i^'ti«ie ^S^^l Increments AlL.H by one and 

P^ares the result Co A2L,H,. .■!J^. ^i^:^ 
-i^^i^S'^tl^ A1L,H, then Carry is s'^- fi^^ & 

returned to the calling prop^ram- 

G2 S3E A2L Multipurpose Monitor work area: 

■63 $3F AZH May be clobbered by Instruction Trace In 

the Old Monitor; see XQT above. 



This field Is the receiving field into which hex 
data le stored from the input area during Monitor 
Command parsing- Uhen the command Itself Is 
e;i^Gountered , A2L ,H contalQs the last parameter 
;edtered- tflille MODE contains zero (until & plus, 
^;^T^s, colon, or period Is encountered) A^L.,H is-. 
.^'^tinually copied into A1L,H and A3L,H, if « 
%i&Bs that)'' sign la encountered, A2L,TI Is 
Iramedlately copied to A^h^U and A5L,H. 



A2L,H Is used to terminate 
display), tape write, tape 
menory verify operations. 



examine {memory 

read, memory inove, and 



A2L,H contains the subtrahend In a Monltfif 
SUBTRACT C 




mm. 




D^r Hex Monitor 

A d tT r Add r Label PeBgrlptloTi 



select f>r out^J^. R^f^ S»^-^; 



.mi. 

tte. 
command. 



6^1 



rfon]tor routine NXTAl -fncrenentK AiL,H by one and 
then compares the result to A2L,1U If A2Lj1[ is 




Multipurpose Konltor 
Hay be clobbered by Ins 
Monitor: see XQT ^fcf. 





A3L,H la used as a worH area by Che Tfe;^ister 
Ul!:play routine, which Is called by the contcol-K 
Monitor. (SQiim^nd, cit. ..ppi^^'. 9f the sluRle cy^^l-e. Ar 




^0t^^if^l see XQT above 



^tifeld (and AST.^H) axe loaded 






f^Ri^T routine Increments A4L,]T by one, and 

f^lp-Tl drops into HXTAI, which Increments AlL,f1 by 

one arK? then compares the result to A2L,tl- If 

A2L,H is less than AIL, IT then Carry is set when 
control Is returned to the calling? program. 



MEMORY ALLOCATION 4^ 



Dec H6?x Monitor 

Addr Addr Label Description 



6S 544 A5L 



Multipurpose Monltgr wc>i^..aj 

This field is not' 
XQT, which. In thfe 

til rough AiT[. 




...... 



irererenG^ i;SIM"ii" the ffotiitor, except that ACC 
(below) is also A5H. 



69 
70 
71 
72 



S45 
S48 



ACC 
XREG 
TREG 
STATUS 



This five byte field Is a register ^ave area* 
IJith i-he fo J r owl n^^^^^^^^si^©^ t^. i^^ i^^mM^S 
are stored by tbe^ ^fe^ttiife. SJJ^ 3?-^*^ ^ " " 

RESTORE routine. 



A-reg Is stored at ACC by the IRQ routine on 
^tEiex an IRQ interrupt or eKecntion of BRK 
toBt^etion, On a BRK, entry into the SAV!': 

at label SAVl is used to store the rest 




^jCiition of a Rf^:i^^^.^i^ 




, of Monitor ee^f^^^lft [ffr^W^^^^-^^ 

^Tit« of this area are used W display the 
tsters" on the screen. 



ThR registers (except S-reg) are loaded; fj:^ ^EMS 

area before jumping to the requested Ir^i^^J^^:^ 
execution of the Hcnitor G command. 

In the Old Monitor Step ^nd Trace conm^nnd 
routines J the registers are stored here after each 



74 
75 



.$4A 
$4b 



unused 
unused 
unused 



l^ec Ilex Monitor 

Addr Addr Label Description 



78 S4E 

n 



RKDL 



Random numVer field, 16 bits: 

Mim-l^. '^U^^^: counted up by the KEYI^'. 

pressed- Thua, t* 



reference Co ''tMs HelU lidtTiin the Jfonltdr. 



$52 



ACt 

ACn 

KTNDL 
KTNDH 
AUXT. 



These three two^byte fields are uied only by the 

multiply and divide routines in ^he Old Monitor, 
These routines are not called from any place In 

the Monitor- Therefore, these fields are used 
only if a user proj^ram makes use of the multiply 
or divide routlnes- 

The section on Pata Hanlpnl-attoxi l\]nctiona 
^atalns a full do^citf'^*"^^- ^^^^^^ 
dil'lde routines. 



PAGES ONE THROUQH THREE 



Pftifte- m&. 'the "hafawaf^^ s^ac^: area, ffiMittjf use 6t tl^l'a a^ka is 
only by means of the 6502 instructions which use the stack, such as 

JSR, RTS, etc. The ^ion;Cor does not initialize or set the stack 
yi>hUer (S-register) on a RESET or Power On interrupt or at any other 



PAGl TWO ($02OO-O2FF) 



Vii^t' two is the Keyboard Input buffer area. At label "GETLN" the 
X-rri: lii ter is initialized as an Index. At label ADDENP the character 
ri'jid froTri the keyboard is stored Into pa^e two indexed by tho 
X-i'''^'J sCer. The result is that on return to the calling program rbe 
M,nrn--tors -^te -^^^^ , I 




PAGE THREE ($03C!0-03FF) 

f',i);c fliiin- runtains "'vectors" for special handling of certsln 

I iiT <*i'i'uptH at the hieh end of the page- The low end of tYs^ P#SS_^ 




763-1^(37 Not used by the Monitor, 
$03F0-S03Fl 100^-1(^09 The Autostart Monitor uses this location as the 

BRK i netrur.C 1 on i n Lf?rr^ipt vc^r.tor (address ) _ 



S03F2-S03F3 10H^-1011 



This is the RRSKT (Soft Entry) Vector (address) 

used by the Mi^^^ ^^m^^ ^3^:*^^ 

the section '^^ 
^Monitor". 




Powered Up indicator; If the Exclusive OR of 
"SAS" with I:he cnntentt; of S^lFl ifl pqufll to 

Che contents of $03FA then the RESET (Soft 

Entry) Vector is considered valid- Otherwise, a 
RESET interrvLpL will cause the Autos^i^St 

Monitor to go through power-up IrtitiiilE? 

Including boot of DOS if availably. 





^3Fa-S03FA 1016-1018 Control-Y Ve^j^ 
S03FB-$|23FD 1019-1021 Non-Masfeable Interrupt Vector (lnstr^c^^%|;#,- 



S03FE'-S03FF 1022-1(^23 IRQ Interrupt Vector (address)- 



PAGE$ FOUR THROUGH SEVEN & ELEVEN 




^Lddress $t^8{^0 iH generally the bej'.inning of memory available to the 

tiser for general program or data storage- Tlowcver, S(^S00 througli S0BFF 
1g the secondary tcKt and low rcaolut ion graphics diapl ay area . By 

POKKing -16299 with any value, the screen display hardware can be 

directed to display to the screen froni this secondary display area 

instead of the primary display area* POKE -16^00,0 to switch back to. 

the. x>rlraary display area- 



■M^l^i^b Eke hardware will dlspJsEKj. tte^ a€#e^ ^fe^ ^ 

-i^Etput to the routine to the appropriate .TJjffi^^S^. ^^^g^^- l^f 
TllSplay area only- Use of the secondary ■ ■ * 

the section "Secondary Display Areas"- 




Contiguous screen lines are not in contiguous nemory locations* The 
characters on a screen line are in the same sequence in inemory as on 



T.he screen, but the lines are mixed in a manner which siopllfles the 
hardware display to the screen.. The following table indicates for each 

m ..^..^..^^ ....... . 



The BASGALC routine In the ^^}0./^'^'-^^6^^^sm the raetnory -i^^ '■^'^e^ 

line nutnber input to that '^%te%. Usmg 'g^'i-^^^-^^^A ■■^i.- ^ 




This c^rn he aric 
place of the ANDS. 





SCREEN MEMORY ADDRESS TABLE 



1 

2 
3 

5 

6 

li 



m 



m 
m 

m 



^'Primary Dl splay Area 
Declnal Hex 

0A00 

0480 
0500 
0580 
0600 
0&80 

9m 




0528 
05A8 
0628 
06A8 
0728 
07AO 
04 50 

0An0 

0550 




Secondary Disp] ay 
Eecimal lies 

0fi00 

0RH0 
0900 
09^0 
0A00 
0AE0 
0B00 



0828 
0RA8 
0928 
09A8 
0A2R 
0AA8 
0B28 
0BA8 
0R.':0 
08D0 
0950 
09t0 
0A50 




!l Is hiIso interesting to note that although 24 lines of 40 characters 



pages four through seven are not displayed ur: Che scieen- 
ai^e eight groups of eight bytes eaqh. This space has been 




'.or 



_, . '$m^-'--^^ "m^ _ , . 

^efaewhere and BjQteett, area in a block, the locations identiitfetf 

^low will be ^^^i^^ If a prograiiT is loa'^ed fcom tape with th)^s; 

t^onltor commaml TnnmTFi • nrinnR , and If mmran Is less than thf_n t'he 

bytes ir the followlnf^ table id 1 1 he loaded from the tape* If an 

attempt is made? to save the screen area to disk, and Isiter BLOAD it to 
Che screen area, results can be confusiug. Ttie Disk Controller card, 

and possibly some peripliersl device interf^ice cards keep control 

inf^nnation in the^e areas< For example, doing the above incntione^ 
BLOAD fron drive 2 when the BSAVK bad been done from drive 1 will 
result in the disk switching back to drive 1* 



The Reference Manual ir.dicates that one must be sure that Scroll 




unfortunate result if thlc caution is not Oi>3*?rved. 



PERIPHERAL CONTROLLER WORK AREAS 




Slot 



Slot 



■4 



Slot Slot 



Slot 



114^ 
1272 

1528 
1656 



0578 
067 R 



0479 

0579 
l?5r9 
0679 



0A7A 
04FA 
05 7A 

0&m 



liM €MS 4§EI 



0Hii7E 
04FB 
057b 




047C 
04FC 
057C 



047D 

04 FD 

057D 
05FD 

067D 



1^4 7E 
04FF 
057E 
05FE 
i?67E 



04 7F 
04FF 

05yF 

05FF 
067F 

m 



* JE^^lqd 2040 CS07FB) has special significance. This location 
he loaded with SCN, where N Is the slot nuniDer of the active 
peripheral, vfhenever an interrupt nay occur and the ROM/PROtl expa:islon 
scheme is in use- This is necessary so that the return from interrupt 
software used allows the proper peripheral card to resume operation. 



The default operation of the screen Is as a scrolling device: new dal^' 

is entered or output at the buttom of the screen and all above is 

shifted up line by line until the oldest information disappears off 

the top of the screen. With a little extr^ work in the user program, 

it Is also possible to use the screen as a formatted display- 
Following is a description of the effects of that type of use, and 

some suggested solutions to the £it^mti^Jto encountered- 



Characters generated by the user prograt* .^^giay on the screen a^.; 
handed to the Honitor one character at a sateen output 

handlers check, for control character vs. display character, and operaB%' 
in accordance with what they find. For esamplo, output of a carriage 
return character or line feed character wlille the cursor is on the 
bottom line of the screen will cause a scroll operation to take place* 
If the screen is bein>; used with a format instead of as a scroll 
device, then the program can easily avoid output of a carriage return 
or lint? feed when the cursor is on the bottom line of the screen* 



The easiest way for the user program to re.id Information froni the 

keyboard la to call the Monitor at the point where it will read In a 
liW to the callij^^ 



losing this t^ ft ^ ^ ■^^^ .it^ 'm ^ -M^m- 1^ " "" 
display. m^m'^-u mmikm tfte t^^^i^SM^ ^^^^ 

: at the current '4 





*^^rlage return, 
t:he cursor current line from cursor to the right end of ^ne ^IJ 
(within the ScroH Window). Thus, the user pro^^fl 
before asking for input from the keyboard the ECtCB^ 
there is no significant data to the right. 




It is possible to divide th(? screen into scroll area and non-scroll 
ares, ^iany complications arise from this method of operation, so the 
recommended 'im.jH^^i 



screen full [m^--. 
^e^irabJ-e^ 



*flie entry tioinVa and qualifiers &r using scrnltl and non-scroll arow 
will be found in the section on Text Output Without the Scrcll Window*:. 

KEYBOARD INPUT DIVISION OF LABOR 



the kn^^^ -mm^' '^mm- ^) the 

posltic^^^^-'^^^ ■en'^m^.^^ae^e^s ^^31 the keyboard ^pi^ ^fl;c^^a' 
(S^fl200"$(j2fTj f-or ffe GOHV^Tif^ffC^ of tfie calling program- 
executing program may position the cursor anywhere (in the Scroll 
Window) before calling the Monitor keyboard input routines. On entry 
of a carriage return from the keyboard, the Monitor keyboard input 



routines vill cause return of contirol back to the calllnj* pro^^rani w| i h 

the character count plus one in the X-reglster and a carrlijge return 

la Che input area as a terminator. The program need not look iTito the 
Qcceea TeftQah memory to determine what was entered. (Note: The X- 



for c^iixm-:mi'^-wm^-mm-:mm-^ ^^.m^^mk^^mMm' 

address, ^ ^r^^^ i^m^ 

routine. 




Routine DeBcrlption 



GRTLNZ 

[3FD67] 

16A871! 
[- 665] 



Entry at this point causes output of a carriage return 

^S*flTSiG%6aF^ asiS: SBi^: t^e^ '^^m 



GETLtJ 

l$FD6A] 

[64874] 

[- 662] 



Entry At tUis point la with tBe cursor oroiierly p^alticned 



GETLH prints the prompt character-'J^ '^^^l^eg'.jS?^ 
indexed storage of the input c.h^T0^^:^^ ^i^^'^^^.f-^^^'"^' 
Control then goes to NXTCIIAR, 



NXTCHAR 




I- 



This Is the top point in the character input loop, RDCllAR 
la called to got a character into the A-reg< xeturji ti^e 

'm.'-M.^m :!^ms^^^ ^ the control-^" tsf&fe? '^^^^ 

^ It ^It" Che A-re& ^fSf^ 



^ !^Q?*Ea-i^ j-he same va-3;fe. 'iSfB" 



^^[^ ;;j^^ie^'yalue is SE^ tir s^reater, the lower ca:^ 'j^-^t: 
^m^^^^to upper caJ=e hy AND with SllF. The 
then stored froiri the A-reg to the Input j^rea. 



If the character is a carrias^e return, Cl.REOL ts called to 
clear to blanks the rest of the window line, and tht^n a 

conditional branch trai:sfers control to COUT so that the RTS 
exit of CGIJT will return control to the calling program with 
the X-reg Indicating the input cl^f^i^^ ^t^tWit -M., Thgt la, 





DJOTCR 
|$FI)3D 



This routine receives control with the character of intere^. 
in CIN,X). The current setting of IWFhG is saved gu the 

atac):, while INVFLG is set to $ff so that the character 



>]S^«EJ£ |-E»a S^^i Is reatored from the- stack. 

-^^ed for t-tther of two ^epect?^'"' 




■ L 




^N,X) is neither Rackspace nor Cancel the value of X-reg 
[^ated to determine whether the input area is full or 
%l,©^;t full> If there are mote than 247 charactere in the 



[64863] 



can[:ei. 

l$FD62] 
[648661 
f- 670] 



After or without the maES|i^ t&^a^N^^g bell, this routiii^ ^ 
control. Here, the X-re^ '5^^|^niented to p'Oint at Efcts^ 
next location in the irv^^. i^^- ®0 be filled- If, h<S)fiff^ 



This routine prints a back-slash through COIJT to indicate 

the action taker, to the operator. Control is then passed to 

GETLN2 to initialize for entry of a new input line - the old 
one i a gone , 



liCKSPC 

13FD71] 

164881] 



On entry to !:hls routine, the backspace character has 
already been printer! through COUT vlth resulting backward 
niouf?inent of the cursor. If the ci.:rrent value in X-reg is 
zero, control is transferred back to GETLNZ for printing 
proinpt and re-initial izl^ m^_m^'^m^Ml^0^^.-.'m^:(^ 
reg Is decremented with c^^i^^l ;^Kiti^: S^l'^ftS 
i^i^t of characters - 




S routine calls BUKEY CO pel: it^t character placed 
into the A-reg, If, on return, it Is found that the F.scap© 
key has been pressed, this routine calls the appropriate 
routine for reading the next character and performing the 
requested Escape key function. In the Old Monitor, controj^, 
ia passed to the F.SCl routiin? for this purpose, after a 
to RDKEY to read the neKt character- In the Autostart 

tJonitor, detection at RDCEIAR of an Ksc^pe character tra 
control Cvla ESC inclu([Insi RDKEY) to ESCNEW, which has thfir 

t^apability of handling inultiple escape functions after a 

ail«f^ .^i#ression of the Escape key - 



1geg,Uesj;ed esc^ape funct.loT^a b^v.e be*^n p^rformed^v 




RDKEY 
ISFD0C 



This routine picks up and saves in the A-teg the character 
from the screen refresh memory area at BASL,H,CH (leaving 
the Y-reg fllle4 with the contents of CH), It then c^hajigiea 



KEYIN 

f SFDIR 
647951 



ESC 

[SFD2FJ 
% ] 



.Tie asks for the next input character to be placed 
Jfeft.^^df^^^h-.reg by doing an indirect jump via KSWLjH, Which ±a 



This is the routine which gets the next input key froin the 

keyboard harduare. There are two required actions and two 
extra actions taken by this routine. The required actions 

are tea^dlns Cbe keyboard input b^iffer over and over a^aln 

until it Is determined (by presence of the bit) that a 

character has indeed been read* In this case, keyboard input 

biiffej: refers to tli& S1&0 byte buffer at $200, arid not W 

the location at $G000. The sign flaj* is set or not by 

checking the status of the value at $C000> If that valiie is 

positive, the routine loops back to KEYIN, If that value 1g 

negative, the value of is picked up and the keyboard 

strobe Is referenced to prepare for the next keyboard input. 

The auxiliary actions taken by this rouLine are first, to 
count up the random number field, ignouirg overflow, and 



second, tn rt^store to the screen area the 
by the RDKEY routine to remove the blink, 
accomplished by storing the A-reg ^ 
RDKEY loaded it. This is sccompUi^W : 

Ig^tSter iB read Into the A-r;^^,. 




character modified 
This restorcj. is 




.roi^tt^^ Is entered fron RDCllAR If the A-reg Is found to 
contain the Escape key code- It reloads the A-reg wi Lb a new 

key by calling RDKEY. In the Old Monitor, It then calls Kf.C] 
to perfom the requested single function. In the Autostart 
Monitor, ESCNEW is called to perform the requested functions. 



[3FJU51 

9iM 



hM^&'^p Is. 




KRCl 





If the key pressed is not I, J, K, or theni 
entered by JIIP instead of JSR so that the RTS iiiff 
the caller of ESCNEW instead of to K^CNEW- 

In the Old ?1on1tor this routine is called by Che RDCEIAR 
i;^aC^ne If the Escape l?ey .^^ .^f^ 



tmm^^ i, j, 6r-'R i-o ^, a, of '"c 

respt^ctively before calling ESCl, which iQturne to ESCNEW. 

If the key la other than I, J, K, or M, then ESCNEW JMP's to 

ESCl with Carry set, to fca^ -^^^^Pitee ^me^^^i 

performed. In this ca*^^ 
to Che RCCHAR routine. 



When ESCl is called, the contents of the A-reg (and the 



>^ move the cursor 



CALLS TO KEYBOARD INPUT ROUTINES 

The following paragraphs describe how to set up for calls to the 
i^nrl%e. 5^1^ .^jfe>ints in the Monitor for keyboard input, and what the 




Write carriage.' i^^r^/^^l^ft 'm$M^k. ^ W 1^ 

Set'Lfp: 

X-ceg, Y-reg, and A-reg are Inaif^nif leant . 
CH is insignificant. 

GV ehould point to the line in the Scroll Window vftiere 

CR Is written, scroll takyc place if appropriate* 
Prompt character Is written through COUT- 

Keyboarri Is read character by character- Each charact^^?^ 
is placed at St^200,X and X is then Increnented- 



^ig^cter is "echoed" to the screen at cursor 
P&sd^Da and the cursor is then advanced. 
On reading ^1/ £§^^5^. ctiutrol is returned to 



calling 



On Return: 





flffrrlage rcti^.tii 
^l^eg contains -i^*^" .^^pofl^t^j.^-* 

location $^200, X contains a carriage return- 
CH contains zero, 

CV contains line number, current value. 
BASL,H contains memory address for GV, WNDLFT. 




Write proffti^- -^^^^^^ -^^^^^^ m-MW^* 

Set-Up: 

K-reg, Y-r^: 'A 
CV and EAS^^ 
Uindnw- 

CH Indicates «here on that line the prompt chdraG^^ % tiS 
be placed, to be fallowed by the echoed key Inpiifi^ 

Line address at which Input Is to begin must be In 

BASLjH. The Line numlier In CV will be calculated and 
set In BASLjK after a carriage retticn has been entered- 




K-reg should be zero to begin storing 
y— re?^ and A— rt^ sret ^nsl gnT fi c^^'^t - 




Wote: For all the above. Escape key functions are supported as 
described in the reference niaterial for the Monitor you have installed. 
Alsoj control-U (right arrow) is supported. When X^at charaeter Is 



'1^ 



RDCHi\Ei Read single fefea ^ifitft .^^j^ueh fee; e^^^ in --irm^^ 

Sct-[Jp; 

X-reg is insignificant, fit ^g^p^g^, 

V— reg Is inslaniflcantf 

[3^A'-4i*«it^ .h54;^4*«in ■•.'iisic. Jt;*^£»i^ cifc^'ii;.'- taiiii'*-. ■^Vi^'^'^a -■^^-itJtJ:*^^ 



^^ts: 

iTie screen character at Cti£? cursor position (}?ASL ) , (CH?^; 
will be set to bllnkin!^ until a key is pressed. 

will be called to handle the requested function. 
Cursor right arrow (control-U) will be returned to the 
calling profiran, not the contents of the screen at the 
cursor. 

Cursor left arro.W k^y (_cori£|y3,l-Hj, ^U^^ fes Ct^jt?^!' ^ ef|g; 
calUnp, pro^^V ... ... 

the 02^i^ area. 
.E.r the character is read, the blink will be turned 

at the cursor position, but the key juEt read wiH n^f 
be echoed to the screen, nor will the cursor (CII) be 

advanced. 

Cancel input line (control-X) service is not defined 

as the data is not bein;^ stored in tlie S0?0^ area- 
special note is taken of carriage return, because the 
rest of the Monitor KRYTN Hautine is not eallod. It is 



^vbg contains the value of the key presEed- 
Y-rcfi contains the contents of C\{, 
X-reg is not affected by the routines called- 
riV , fill , RA!^T. ^ Tl wi 1 1 have chanp^erl onl y if an Fscape key 
function has been utilized. 

Read single character thru KSWL; return to caller in A-re^ - 



;fe^p: 

X-reg, Y-re^, and A-r^. are insl^nlf'^G^it*. 
CV and Rflf5I-,H shoulf^ SO^p^l^ei^i -^^aift^^. 
Scroli li'lndotf. ' \' ' 

t-Ei^^^^Ki^^ ^hf!^ _i^4-^nidt -^^tf^iik^^ ^m^-^i^ 





^hai'scter nn 
bllriklTTg, 

^feCS routine is 

.^imilng of the 




■Return; 

A-rej! coptainfi the character from the. keyboard* It mty 
be any character, iifcliidinfi Rsoape, carriage return, 
right or left arrow, or any nthpr eP'-Rt'I^OJ^ fjH^JTil©^^.^* 

X-rei» is unchanged from tin? call. 

Y-re^^ contains the contents of CfU 
character in the 
fes been restored tc 
m HiTilj hy RDKEY, 

GV remains unchanfred- 
Kfead single character from keyboard: return to caller in 'A^'r^ 




X-rep is unus^^d and iii»affected across this routine* 

jfl^r=^^ input to this routine wliat will be stored Into 

tsHE screen area at the cursor position Cl^A!iI.),Y to 

remove , the blink condition after a key Is pressed - 

Y-re^ is set tc he used to store the A-re^ into the screen 

area to remove the hll nk at (BASh),V, 

.GH and CV a.re not referenced, but should be appropriately 
\ li^. .^-j. -fl^w'-.iit^a -^wjt^iirt^i^' «*ii»--''i^i-s,ft;-ffl^ 



KEYIN ROUTINE REPLACEMENT 

There are cases in which it in desirable to replace the physical 
keyboard input routine with a routine which either reads From the 
keyboard and preprocesses the input, or gets the information to feed 
to the reading program from some source other than the keyboard. The 
requirf^nents of such a program in replacing the KFIVIM^ ^^^^^Ij^fi- 
described below. Placing the proRram/rou t i ne into e^J^i^t 

gcconiplished by storing the entry p^int In KSWL,K- 



\\:' replac^es^" TCEnt&^e. sfeoaffisnraHi^e risPEaimEeses^ 



X-reg 




whatever Hourr_e la t^} 



Must be unaltered- Save on entry antl.^ ^KSfel?^ ^ 
it must be used by the replacement rQti^^>; 



V-re;^ 



Use as indicated above for A-reg. 



It nust not be changed on return from contents on entry, 
so save and restore if it must be used otherwise. (This 
^^iMiutlon is not required, however^ if the source of the 
.&put prevents Escape key and right arrow from being 
entered- In such case, the Y-reg is expendable.) 

These are all used for echoing the "keyboard" Inputs 



Nf)[i:: On replacing the pointer to KEVIN at KRWL,il, it Is generally 

s.ifer ttj pick up and store t!io current contents of KSWL,H in a 

Siive area before placing the address ol your routine, and then 



way m^^-tmm m W ^ ^mw^ ^^^^^ 

Depending upoji ymit-- .^f^l-fe^^^, p .i^^- 'be ^ 
replace both ^ir^t^T^'m ^t^^m:^^M:M 

screen wil.i not pass P^fe' """" ' '~ — . . 

F.()(>n as possible. 



KEYBOARD INPUT MONITOR ROUTINE 



rhi ,ire inany points in Keyboard Service wliiob a user prop.ram could 
uJiorully call. However, because they are generally different locations 

iM IV. ^m^m$ # ^^^^.tion^ afte^ t'm' 

.pa:ti*t m &tt^. ,1^ ^is&^^^ '^^^^c^ <jf 'fel^-^^ie addresses oj^' 



■'mt^- ^tiiat. th^^ '^^tm m^- m$i ^ci^ied pQirit,_ ail of 



KEYBOARD INPUT Arm<§sra4®WP^ .25 



Ties +Dec -Dec Monitor Rej^tst* 
Addr Addr Addr Label Destrov 



BOTH MONITORS 

Call RDKEIY to i^eC next ch^iraccer 
Into A-reg» 

Compare to $9B (Escape), 
If - BR to ESC to call for ntxt 
character and do Esceipe^ 
Else, RTS- 

'^le^ $^0 blink at c^J^ 

^^i^ ^^inal character- % 

K-r&i "^f^o^a CbASL) ,y 

Jump Indirect (KSWL) to KEYIH 

Increment random number at RNDL.H 
wh?le pol Hnji keyboard register* 

Store A-reg co CBA3L),Y (clear 
blink set by SJ)KEY routine). 



FD35. 64821 -715 RDCHAR A,Y 



FD^SC 64780 -75& m^t .ft^.V 



FD18 64792 -744 



FDIB 64795 -741 KtlVIN 



A 
A 






.^scapG key seruice- 



A ADVANCE 



D UP 

E CLREOL 
F CLREOP 
other 



clear scroll 
cursor risiht 
cursor left 
cursor down one line 
cursor up one line 

clear to end (if li^ie: 
clr to end of vl-n^^i^f 
ij;nore; RTS 



et port V tki?yb 



to, FE89 6516^ 



fov Escape key service & ?D2F 
^'il ESCJ with character In A-reg 
and Garry set to do Indlcatetl 
functlnn- Return is to RDCMR. 




64315 '721 ESC 



AUTOSTART MONITOR 0?^LY 

Call RDKEY for Eaoape key service & FD2F 64815 
Call ESCNEU with character in 

and Carry set to do indicated 

-function. Return fr-om Esc^p^ 



-721 ESC 



A,Y 



--HI 



Hex +Bgc -Dec Monitor Registers 
Addr Addr Addr Label Destroyed 



Set Carry flag and JMP to ESCl 
to handle 
A, B, G, fff^, 



FB97 64407 -1129 ESCOLD A,Y 



Handle Escape key functions 
I, J, K, Translate to 

I), B, A, r. and c^^ll KSCOLD. 

Then RDKEY to get next character 
and drop into KSCNEW to continue 
Escape key processing. 



Escape key processing entry point- FBA5 64,421 -1 U5 ESCNEW A,y 



and Handle it with reCufii t^r 

ESCNEW. Otherwise go to ESCOLD 
to ba^^dJe ttf.s entry and exit 





Logically speaking, the place Co start below Is GETLNZ, but th^ 
.sequence of presentation here Is the sequence of instructions fe; 
Monitor because of heavy use of "fall into'' next code segment- 
Note that once the Monitor is jumped Co at the specified point, all of 

the Initialization described after chat entr;? jkilnt Is also performed. 

f^^Clon description. 



Echo keyboard Input thru COUT to 
the screen, from 1N,K, with 

INVFLG temporarily set to SFF. 

EMilf up character frorg 

t f $R8 aoto BCKSPC, 

i f S98 goto CANCEL- 

IF X-reg (input index) greater 

Chan $F7 fall into FD5C. 
Klse goto NOTCRl, bypass Bell- 
Sound bell If X Indlc^^^^ 
Inpuc characcers- 



—Dec Monitor Re^?i ers 
Addr Label '■•i n^jVi-d 



mm »f 



FD5C 6486tfl -676 

64863 ?3 HOTCRl 



Mex +Dec -T3ec Hani tor Rt^s^, ! s 1 1» rf: 
Addr Addr Addr T.abel L roy<?<l 



Load SDC C\) into A-re^ . 

Backward slash indicates 
input cancelled , 

Call COTIT to print A-xeg, 

Then fall into GETLNZ, 

Print carriage return t^ix^, 

Load PROUPT into A-reg- 

Eall CDOX to 

^ihad X-reg vritTi #1 for tia 
thru bacl:spai5e operation. 

If X=4 goto GETLMZ to start ovefe 
Else, decrement K-reg and 
fall into NXTCHAR, 

Call RDCHAR Lo get next character- 

If character received is ctrl^U 

($93, ri^ht arrow) pick up the 

screen ch.Tracter from (HASD^V 

to replace it in the A-re^, 

-^^^g greater than th^fx. 

kW against $W to tnjike it 
upper case. 

Store A-reg to input area at IH^^ 

Compare to carrias^e return* 
Goto NOTCR (above) if not. 
Else, call CLREOL to clear the 

rest of the line^ then print 
carriage return thru COUT, 

using KTS from that function to 

accotnplish return to caller of 
keyboard input * 



17)62 64866 -670 CANCEL A,3<,Y 



FD&4 
FD67 



64868 -668 



64S7] 



-665 
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IN 



Q^M^W^TEXT OUTPUT TO THE SCREEN 

Thp highest level of support in the Monitor for text output to Che 
screen scroll device support. In addition, the Monitor contains 
many components which support use of the screen in a formatted maoMeE-i 
Because there are so many ways to write text to the screen, the fi^^j^ 
of screen output has beeti divided into the following sections.; 

TEKT OUTPUT WITHIN TItB SCROLL WINDOW 

ftescrlbes the normal inmntec of text out/^itt, de^-iriij-^ .^W; ^|ia£^'^ i^i. 

^ge Kero which 0^ '^^^ m t^iSi|f^^"^^ ^^c4#a%".'sa*^=iiEyk aifi 



SCHEi'N FORMAT CONTROL 

identifies the entry points % means of ^^^lich display 

(full mm^'f %f^^,.mm^ graphics and -^m^ 

Window :Bmm^tMMm M^m ^ cMack on mmm. 

describes tlouitor calls which clear all or part of the Scroll 

Window, set parts of the window to some user specified value, or 
cause conditional or unconditional scrolling of the ulndow< 



C[)RSOM POSITION CONTROL 




TO THE .SCRKEN 

,S=^^'-^hes the Monitor entry points to, output user progr^Tn 

- . . (jg^^g j-Q ^-i^p screen or to the current output device if 




£i feas been modified- Al&o, entry points are described to 
trsnsmft standard types of output (blanks, bell code, carriage 

return) to the output device (general^ 



TEXT OUTPUT WITHOUT TJIE SCROLL WINDOW 

describes the entry points used for placing eharactei;'! 
screen outside of the Scroll Window^ and for reading. 
when echo to the Scroll Wlndofer -i^. tO:. be 




^jihtf to go to the SeeortS^fy atea. 

Any entry point which fits into more thaij' 
in each appropriate address table. 



OUTPUT WITHIN THE SCROLL WINDOW 




$<;;r<ii3. W4nd-W P^^^-tJ-^.^ .parapatlble with printer or t] 
ojifci»^. iit-^Hial: ^^mG^^Ts are displayed to the right 
Dilt'phjt, ^nrf T^ew Ite&a asft Nlisplayed below previous lines. It: f^ 'tMS 
mode of operation which Is described in this section. That is, this 
sectlnn describes "printin^^" information by means of the CJiVTL vector 
to the screen or to a printer type de\?iee. The section on General Text 





The nomal metliod provided in the Apple II for displaying output 
Information is by "c.allinR^' COUT with the character in the A-reg for 

*i -'trr^.S-t- i,^-^*. ■^i'tA*.. ™»trt 



each dtsplayable character or format control character (such as a 



KEYBOARD INPUT AND SCREEN OUTPUT 2? 




function. When the sysj:^ -5^ 
|0 feo point to COUTI which anj^ife 

QufcVt device fcfeK-F'fV ti^'^'Sfe'if feWl>- 

CSUL vector will be set to pass the output bytes ro ttie selected 
peripheral controller card Instead of to th.e *^creeti. DependinR on 
which perlpherijl controller card, and ^Jh^<^)} cOnCrole are acrj.ve, the 



^e nomal ^lode of text output to the screen is In "scroll" mode- In 

ifchie niode, new Information is written to the bottom line of the 
^T^ien^ and the contents of the screen are moved up, up, and away as 
^^ii3^^:ti^ *illGW entry of new information below the old- This niode of 
%S lased In APPLESOFT or BASIC "PRINT" statements. This Is the 
^l^^t uaed by any Monitor command whl^h dlsplnya data to the 



As new characters arc vritten to the screen, the/ are placed at che 
position of the cursor- The cursor position ia a location on the 

screen (and in screen refresh memory) specified by the contents of 
certain fields in paj^e zero- Also, tin; Scroll Window is a portion (or 

all) of the screen as defined by the coatcnus of certain fields In 




column and ^fi*^- f^Ti T^'t-.f^ l^^^iSiC.. ^ ^^^f^t^^M -l^S*. 



l^- m'p 



The cursor posltlori la defined in various ^j^^fa 
program interferes they will be compatible- 

The screen line number of c^irsor position Is contained In the field 

CV- CV indicates the line number of the cursor relative to the top 

line of the screen, not the Scroll Window- (Note that this Is 

different from CH, described below.) The screen refresh memory 

location which corresponds to this line number is maintained in the 

two byte field CbASL,E). Note, however, th£ft if the left edge of tlfo 
Scroll Window is not the leftmost character of the screen, BASL,1! wilJ 

have been adjusted tp p]Eji^t: J^, tTie leftmost character pGlS±tlo^a on that 

line within the Szt^'^m^^ . ''"^^ '^^^^i^--^ ^ 

aetermlne -the liim m/^!^^ .■Ca^Sfittrj'' tet ^E^g^ato imnmt^: 




The horizontal position of the cursor is inaiutained In CK. The value in 
Cll is relative to the left edge of th^ Scroll Window, not necessarily 
to the screen. When a character is being "written" or "printed" to the 
screen, the routine which places the character in screen refresh memory 
uses the Y-reg for horizontal position, in the assumption that it has 
tree^i ^Q^^ed from CH* In the address table, each description indicates 
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For machine lan^»uase prograQS, Gcroll Window output is most easily 
aecompJlGhed by a JSR to COLT at 5F0ED (-331) with the byte in the A-r 

m^y I^^, tW m^. ^ m^^^^ ^ ;m^m^-$^"^ 

^^tH' Wtwaa :M£^;'.fl- single command- 

'tiie AaraciietB are passed through COUTT , they are modified. If 
T^^-^. ttiEj^ , to be written in white on black, black on white, or 
f^^te^ii^, in accordance with the contents of the field called 
-Jltp:^ field can be set (PO^Ed) at any time, and Is immediately 
eMective on all future characters printed by the program until it is 
^gain modified- This function only applies to program print output* 
During keyboard entry, INVFLG is temporarily changed to $FF as each 
Input i^haracter is echoed through CO[!T- 



mm mm 




Dec Hex Rou tine Description 



M $30 WNDLFT 



Left column of the Scroll Window: 
Range is to 39 CS27)- 

This field is used only in VTABZ- The co:itentS, 
when changed by user program, become effective on 
the next scroll operation, clear to end of page 
Operation, or carriage retura output- CH contains 
CHi^ear .te>c-t&oot^l jioBltlon relative to CWNAXJ^T^). 



:^^DTT1 



Width of the Scroll Window: 
Range is I to 40-(WNDLFT), 

When a character is written through COUT to the 
screen it Is placed at (BASL),CCH)j after 
is incremented- At that time (CH) is comi 



(WNDWDTH) to Jetertiilne whethet the ^?£t^ja<*# 1^ 



exceeded 



^3% 



Top line of the Scroll Wlndowi 
Range Is to 22 ($16) for full text screen, 
Range Is 20 to 22 
and text* 1 
operatlQ^r^e 
start . 




v;?iD^ roi: ruj. -i text &ci een • 

2 {^H to 5^^.) mixed graphics 



^MBOARD INPUT AND SCREEN OUTPUT 31 



Bottom line of Scroll Window 
Range Is (WKDT0P)+1 to 24 ($38)* 

lindi^tes ^^.^^0* Une number ^elow the 

.^-^^^^.'^--l^^ are tested only on 
t i^-.^^^^^. '^hm^.. C$aD) or litte feed 



DisplacemenL from WtlDLFT vh^Q-n 
the screen will be placed; 
Ran^e is to (HNDWDTH)-K 

After the screen output routine STOADV ^^^■es'.;^'^ 
character into the screen area as part, 
character output, CH is then incremented 

,^ p t% m m mi ^ ^ 





Rote that CH la used fpr echoing keyhoard input to 

the screen the Monitor routines OZTlM etc., 
because COiJT is used- 



Vertica] screen position (line number) for ne>it 
character to be written to the screen: 
Kange Is to 23 ($17), 

The content of OJ is relative to the top of the 
screeii, not to the top of the Scroll Window, It 

may be set by loading the desired line, number into 
A-reg and calling TABV- It may he set by POKF.ing 
the line number into CV and then calling VTAB, 
Actual storage of a ch^r^cter Into the screen area 




'hel.^w WHPB^, It will T^main on 
,m .carriage returns go hy while: the 




two byte field Is the memory address for the 
t end character position of the current text 
line, within the Scroll Window. The cOnt&Qta ara. 
function of GV and WNDLFT- 




Thia fifcid is set by the BASCALG routine to 
ta the memory address for the left end of tli^. 
specified in the A-reg. This call to BASCAL0 
usually accomplished by the VTAB routinj^ 

then adds (WNDLFT) to BASL,li to point t^'tt^ 
end of the line within the window. 





This two byte field la nsed as a work area only 
during a scroll operation- Ir is the destlnatl^ 
line pointer used ag ©ach line ie moved; ta. tlie; 



^Bsi^s '^i^^-:. _§,ss 'a mask used ^^J^-i ^jO- '^^m^f- 

^^eil^i'-^itten to the^^:,^i^.:W".;^a# 
white on tlack <INVFLG=SPF) or Mack on s^tt6 

(INVFLG=53F) or flashing CirJVFLG=$7F) . This fi^^ 

is set to $FF when a RBISKT occurs by tae routine, 

at SETNORfl, The routine called SETIHV can be 



YSAVl 




INVFLG=S7F does not cause all charactera ■ 
^iW^ the upper Z bits of the character must be 
for flashing to oCcur- 




This h^te is a &a,ve. area for the Y-rej^ .a,^ro>s a 



Sld contains; the address of the 

to receive and dispose of output 

characters. When the RESET key is preHsed, this 
field is Initialized to piilnt to COUTl to send 

output characters to the screen. Entering a 

Monitor Command nPc (n=port number, Pc=ilontrol-P) 
i5?ill cause the ttonitor to set CSWL»H to Cn00, The 
?^outlne at that location will then receive (in the 




SCROLL WINDOW OUTPUT ROUTINES 



liex +nec 
Addr Addr 



-Dec Monitor Regtsters 
Add r La h e 1 Beat roye4 



Write byte In A-tf0;.i^'-$ 

cuTfiov <GV),CCh| 
■iMj)porf. iu^, cursQ^'^JH 

Ur i tG byt f in A— 

C(:v),fc:iO with 

not tNVKLC- 





mm 




-rj- ^J-x- - 



Hex +-Dec -Dec flonltor Rej-isturs 
Addr Addr Addr Labial Destrtjyi'd 



Print carriage reCarn thru C6W. FDSfT 
PrlTit thru COUT "ERR" and bell c:odG,FF2D 



frlTLt bell code ($87) thru COUT, 
^'Set BASL,H from CV (and WNDLFT). 

■get iiASL,H troiu. and mmx 



"FT 3 A 
FCZ2 



^910 
65325 

645^6 
645.48. 



"211 

-198 
-99^ 



cv 

GBASL^TI 
BASL,H 







WMDLFT 


32 


-tiJ...>:J...... 1 rn if.i; 


37 


$25 




33 


S21 


38-39 


S25-27 


UNDTOP 


34 




4(J-^i 


$28-29 
», 


WND5TM 


35 


s:3 



caouT 

PRERR 

BELL 
VTAB 



A 
A 

A 
A 

A 





Cle<ir KIRES graphics niijde- 
SeL display area priiTary- 
i^et TCXT mode. 

Load into A-reg for WNDI^^.. 
branch to SETWND below- 



Hex -H}ec 

Adtir Addr 



—Dec HonitorKegleters 

Addr Label Destroyed 



& FB33 



64307 
64310 



4 229 
4226 



A 
A 



fe^' ^i^'phicE' mode. & 

mixed j^raphice / text inode, 
jfell CLTtTOP to cletir graphics, 4 
toad 22 CSIA) into A-rej* for set S 
of WNDTOP- Fall into SETWm). 



Set top line of window (WNDTOP) 
from A-reg, or 20 or user set 
Fall thru followfne. 
Load A-reg with 3 for UNDLFT. 
Score A'-reg to tfflDS^FT. 
Load A-reg with 40 for WNDWBTH, 
Store A-reg to WrJDWDTH- 
Load A-reg with 24 for WNDBTtI, 
Store A-c*^g to WDBTK- 
U)ad A-reg wlch 23 for VTAB. 

m 





64323 
64323 



-1216 SETGR 

-in? 






FB4i; 


64333 


-1203 


& 


FB4F 


6^^3'j 


-1201 




FI131 


64337 


-1199 


& 


FB53 


64339 


-ll<}7 


& 


Ffl55 


64341 


-1195 


& 


FB57 


6434 3 


-1L93 


& 


FB59 


64345 


-1191 



A,Y 



FB4B 64331 -1205 SETW^KD A 



A 

A 
A 

A 

A 

A 

A 



Hex 4-nec -Dec 
Addr Addr Addr 



Monitor Fegisters 
Label JJestroyed 




Vail 'to© '£ 



?^tore V-reg in INVFLG and RTS. 

$yF whine on black (from SETNORtO 
S3F black on white (frojn SETIW) 

$7F flashing Ct:haracters from user call with upper 2 bits of 01) 



Sft CSWL.Ii to point to COlfTl. 



r.n 

INVFLG 
BASL, El 



36 524 

37 525 
50 $32 

4^-41 




FE93 65171 -365 SETVU) 

.■i-r.'.hV>.iVH>f.^r.rsfti 



WNDLFT 
HNDHDTlE 



32 
33 



A,X,Y 

ir>'.ir--v.?.7i^*:^'ii-w- 



$20 



SCREEN FORMAT 
BY POKE/STORE 




111 (Tiaoy cases, the routine in the Tlonitor described on the previous 
P-ip.c exists ber.aiise the tlonitor iLself uses Lhe function described. 

f>ft<_!0, calMnj'. the "lonitor for a specific control function is doing 

the bard way- This table indicates other ways of accompl isblng the 



Func t ion 



riethod 



— ^ 



Sei f.HAPITLCS display 

Sn Ti:XT disolay ii^ode, 

SeL ;;HAPKIC? mode to full. ^^'.^^ 

Sol mixed craphics and 'm^ 

Set left edj^e of Scroll Window. 

^vl width of Scroll Window. 

Si-l rjorrrcal (white on blacfc) text. 

Sot Flaahlnp^ text . 

Set lTiv;er!i]e C.fei^ir-lf. on ^it^i text 



POKF -16304, or 

POKE -16303,0 or 
POKE -16302, or 

POKE -16301,0 or 

POKE -16300,3 or 

-16299,0 or 

-1629&,0 or 

"16297,0 or 



ST A C050 
ST A Cp^l 
ST A C052 
STA C053 
ETA C054 
STA C05S^ 
STA C056- 
STA C057 



34. line-number (0-23) 
SSttoTn ™st be greater than Cop. 
POKE 32, column-number f0-39) 
Left edge + width not to exceed 40- 
POKE 33.nunber:-of-colunins Cl-40), 

Left edge + width not to exceed 40, 

POKE 35, line-number (1-24^ 

Botrron must be i»reater than top. 

PO^K S0,?55 or store ^VF in $32 
POKE 50,127 or store 57Y in S33 

POKE 50,^3.^ tit.6tG.53F in $32 



If the above fneans ar<i used Co change the Scroll Window coaf ip.urni t i on , 
the user program should also take steps to Insure Chat the cursor han 



,ems^ regardi:^ ffip^-^V^i^^^^^ ^'"p^^- Screen gra^^^ife- 

set tings. 



SCROLL WINDOW DATA MANIPULATIONS 



This table describes three types of Scroll Window dat^i manipulatt^ift 
.entry points- The first Is ftonitor label ESCl, the Escape Key 
^l^^se^^j;^ because it transfers control to a number of the OE'ilfe?:. 'e^X$^: 
'"'""'"ft^; ^^^^Ing upon the A-re^-, contents and Garry being get, ;^e. 






■§tT&m : 
If Carry is set 

goto mm 

A goto ADUArJC^$ 

B ^>oto BS 
C goto LF 
D goto []? 

E goto CLREOL 

oth^t RTS to t^aller^ 

■The RTfi aj; the end of 
these functions r'^tuv'S$ 



P SI 






Hex +Uec 
Addr Addr 



—Dec Honitor Registers 
Addr Label Destroyed 



riVar from llne""(CV) col (CH'S^ 1^? 
I'lii'l of !^croll Window- 

(:h^■l^ frum line (CV) col (Y) to 
i-jid of Scroll Window. 

Clear from line (A) col (Y) to 

of Scroll Window- 
'P^i^t Scroll Window to blanks, 
■&sit m^^r- tQp a^ef t corner 

W^-^ to EOF 
t^<^i ^f^'>age = end of 
ei'tt^i*J^i&dow from line-;*"" 
hiniik, set cursor to li 
I Ine (CV) . 

' lojir line from CS^W 

((llAiil,>,CCH})< 
Biipar line from cnrsar (BASL 
character in A-reg From 

ciirsor (RASLj-^Y to ROLlne. 
Clenr line ^^t'.^'. ^tien set 

BASL.H fr^ W ^ W^DLFT, 
PiBr&r H''^- ^^^^ cursor (RASy^^ 
■.t)im^ BASL,H from CV & ^ " 

Cf! remains unchanged- 

[o A-re?, for CH. 

;( <ir<' A-reg to CH» 
I nr roncn t - 

LimiiMr.' t^V to WNDETfT. 

Sri p^SL,^I; if ccv) < Cundrtm), 

do srroll if reqiiired- 

St^ri-iJI the window, lines (CV) 

thru (WHDmO. 
Scrall the wlndtlV, U 



A<ito fitart Monitor extended service 
■■^ct Carry flag and JIIP to ESCl 

> a 



mm. 



-956 




FC95 



-875 SCRL3 



-873 



KC6: 
FG64 



6461^ 
64612 



-926 
-92 A 



R 



-954 CLEOPl A,? 



i 



A,Y 



A,?Y 
A,?Y 



?C7'? 6.4&^^t -912 SCROLL A,Y 



FB97 6441*7 -1129 ESCOUJ 4 




ClI 
CV 



36 
37 



S24 
$Z5 



WNDLFT 




32 
33 



$20 




1^ 



CUR^R 




CONTE^l 



general, the Cursor is at the position indicated by the contents of 
(line nijmb&r relative to top of scret^n) and CH (column number 
relative to Co tbe left margiri of the Scroll Window)* The memory 
location of the cursor is the suiii of the contents of BASLJI (whJcli 
contains the address of the leftmost character of the line within the 
Scroll Window) and the contents of CH. Normally, then, BASL,H contalni 
an address computed from the contents of CV and UNDLFT, However, IT 
either CV or HNDLFT la changed without recomputing BASL,H then the 




%p: the following table, the descrlp^tion includes Indication of iJilch 
^ the cursor address -fields is being used for i^at* tfote, for 



The ESCl and VTt)OlIT rootlnes are included in the table bpcause thev 
can be made to use (goto) the other entry points by pasRin^i tlieir! the 

appropriate A-re^ contents on entry- VIDOUT is the routine which 
handles CR, backspace, and line feed wlien such characters are sesC 
through COUTl (generally thru COUT), F,SCI is the routine calleA 

accomplish the desired function when the keyboard routines are 
operating in ESCAPE key mode- Thusi , it has four way cursor mo' 
capability, as well as the capability of clearing the Scroll Win^fi^ 
^ji^S<J^ pXBsent position to end of current line er .ea4. f^- i.C^ 






2lae third group is entry poinCS k 
relative to its current position^ 




The fourth group supports positioning the cursor at fl dealred locatioff 
wlthoijt refa^enc^ tO Its cnrrent position.* To. do this, the progiram 




TABLE 



V.:\ I 1 sc reen/ cnrso r man i pulatl on « 
ir Carry is set and A-reg = 



A 
H 
C 

n 

V 



fiOtO 

£OtO 
ROtO 

RoCo 
goto 
EOto 
goto 




other &¥S to caller* 

Tlic KTS at the end of each 

I hi.!^<' functions returns cont&I 
f o the caller of ESGl. 
Si'L Ciirry flaj; and JtJP ^^J^^ 
i*- handle Escape key 
A, !i. D. 




If --'^ " S8D goto CR, "' 

Tl Mm ^ $«A RotQ LF. 

M fM - goto BS. 

if M = sound "bell'\ 

If (A) =- other ignore It; R^S 



Hex +Dec -Dec Monitor Re^^isters 
Addr Addr Addr Label Destroyed 




4W 





('Ai-:ir Rrroi 1 Ulndow^ set Ciirsor to 
lop left corner of the window. 

Si'J Cll=i^, CV=(A), clear to EOP 

Uit^ pai;e = e.n^ SJiK^^^^l^. 

rArnr line (BASD^ then set 
llA!ih,M from and WULFT.^ 



FC5a &4600 -936 HOilE 





hiwkj Y I \->m FBF0 
!'lorr A-i L'y^ to scrcen at (BASL) ,Y £, FBF2 

] ni reiin'iit . 

t:iiin|viri' (CM) with {WW 

CS Cii mit less. 
^jm- U^-t on^ coiurni, to 



o4496 -1040 STOADV 
64498 -1038 




A,^ 

A 
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Hex -HDeC 



a FC62 




Hove curfior up one line 
if CCV) < (WNDTOp), 

Zero to A-reg for CHi 
Store A-reg to GH_ 
Increment CV- 
Compare CV to WNDRTM, 
If CV not less decrement GV and 
do scroll- 

If CV less goto v^^ m-mt- 

BASL^H and return- 

■Plffee cursor at line (A) col (CH) 
(store A to CV and set BASI,H 
by JJ1P to VTAB). 

Set BASL,H from CV and WNDLFT 
by call BASCALC and add WNDLFT. 

Set BASL,I! from A-reg and WNDLFI 
by call BASCAJ.C and add WNDLFT. 

Set BASL,H to memory address for 
left character of line in A-reg 
(not left character of window)- 



Jump via CSWL, character prfot- 

' ^^^^i^^ til' ^'rm 

a^J^Spriate actions on contro4&^ 
^ntrol characters • 

goto COUTZ , bypasg 
inverse video mask, 

■ ^.v ii. i n . . . 1 , I i h.r ,11 . 11 I ^ i .i,- .f. 

AUTOSTART MONITOR ONLY 



6A61^ 




FC22 64546 -990 VTAB 



FDED 65005 -531 
65^08 -52 S 



COUT ?A 

coin^i ?A 



Frlnt character to screen via .WB^& ^^M^ 

VIDWAIT (pause If operator request.^ 
and VIDOUT with save and restore 



OLD MONITOR OfJLT 
print character to screen via 
VID0E7E -with sa-ve a^id restore 



■^a-r-if:.:^ri. 




3fi 
37 
50 




WNDLFT 32 
WNDWDTTI 33 
WNDTOP 34 



$20 
$21 
$22 
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GENERAL TEXT TO THE SCREEN 



Hie preferred method of sending text to the screen is by loading che 
(liaracter desired into the A-reg and calling COUT to handle It frojn 
l-here. The reason thi-& t^'-^^^T^^ fe; ^fe^V 

ijutpiit to some device otTiei-^ '^k ife'Se^^V ^^J^" S^fc^^-. 

t.o point at the program supporting such othet device, "^^^k ac^r 

^J9tfefl, however, wben you'll watit to write to the screen. 

the setting of CSWL,H, COUTl is the entry point for 
output, where reverse video display or flashing characti 
iiMtiiR rNVFLG, Entry at this point for the Autostart MonS^^. 
billows you to stop output, using the control-S key* 

C(HJTZ may be used for output to the screen without modifying the 

rlinracter by using INVFLG, That is, calling COUTZ with a character In 
(lie A-reg will place that character ou the acireen aa is, wttli6iit using 
INVFLG to display th^ character In inverse yi^eo ox flash 1 iig Tflode. 1%- 

m 







VIDOUT is t|^^ . j^t-infei^l^feit ^tt«^|^t;a the character and places It on 
t. hf screen If It Is hot a control char;?cter. If the TlDOUT routine is 

to he called directly (to bypass control-S handling In the Autostart 
M(>nItor, For example), then the calling program must save the A-reg 
.iiirf V-reg before and restore the A-reg and Y-reg after, because they 
III' hotli destroyed In the VIDOUT routine. 

OiiLput to the screen may be written via these alternate entry polnts- 
llowever, note that the Monitor v/fflf. !5i^.A^^^';^g/^f^:j.^^^*^i^ 
Input echo function, tm^orarUx ^^^m ^^^^f^^M^^ -iW^^^^'-M- 



other entry points 

mwT) without tha oai&^m^J^ii^^ % W 4rm 

hcfore the cal 1 - 



ADDRESS TABLE 

■PtU^ti;0B' HeK +Dec -Dec Monitor Registers 

Addr Addr Addr Label Destroyed 



Print a byte to specified output ^SiS^' "^"^^ j 

[kwlce by JMP (CSWL), normally 

COUTl for screen. 

Cltnrji.cter print to screen output 

routine entry — normal for CSWL- 

Print character to screen "SgB^l!^ 

;M'P'''^pr" late act Ions on confeatS 
nnd control characters- 
tf (A)<$A0 goto COUTS^^, 
Inverae video raasfe- 
Am XA) with m^^^^ & FDF4 65012 -524 ?A 
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Hex 
Addr 



H-Dec 
Addr 



^^1^-' a byte to Che screen- 
See AUTOSTART and OLD differencea 
toward t?nd of , tt^^H" ^feaMe. 

VrocG^s c^ar. $^f,^^J^ %ii screen. 
If contro.l c^mkb^'ki' 4^ ^^t^L^ 

^c'tee-n rM^if'esti Mthof^'^ 

Store A-rej^ to screen at 
(BASL,H) ,(CH), then increment 
C}] aticl p;oto CE if w^LtiJow exceeded. 

J^tore A-reR to a|, to^^^'M^^ 

exceeded » 
Increoient CU nd ^^oto f^R if window 

exceeded , 
TeKt C!K Goto CR if CH => WMDWDTII- 

■If A=San, S3A, SBfi, or SR7 do 

Sf^D carriage return ^oto CR 



-Dec 
Addr 



Monitor Register!: 
Labe 1 Dest royed 



Ttii^ -i^.!^ 



FBFfi 



5^8A line feed 

hacl*: space 
;SR7 bell 

TI-C to $FF = normal 

^?^:i.c; from Y-r^g 



goto 7.F 
Koto 

fiiijuTid "bell" 




■-ft 



FEa4 



MSB 



-3 fit? 
-37 R 



SKTirJ\^ 

SKTMOKM 

SETlPLCi 




VIWAIT fstop if 
and VTDOIJT with Ss^ 

of A and Y r'.'ir_Sm 

Test for operator pan.^e reouest* 

If CA) = S?^D (r.arriage rectum), and 

if keyboard rei^ister is full, and 
if keyboard rej^ c-i:;mt^i^ e'l^.r^^.- 

than fall into KB^^^gf^, 
tl'W^ YIDOIIT. 

per operator req^;j^^^i< 

how ^^^i 

if tieJtt key pressed is p^JHg. 
then Roto VTDOUT, 1 eavW^ =<^cit$^^t 
Xxi kpyhoard reF^i^ter- 



Y 
Y 

norie 



■fir* fTOnlTOR ONLY 

Print character to j^cirecri via 
VJOOfTT with Solve ^nd restore of 
A-res! and Y-rej^* 





3r. 




UNIU FT 


32 


$2^? 


cv 


37 




WNDVfDT'l 


33 


$21 


IKVFLC 




S3 2 


WKITOP 


34 


S22 


TiASL^lI 




S2R-29 


WNJJRTM 


35 


523 
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Tlir following control cKaractera have spe*;lal tn^anloga for screen 
d I Hpl :iy . 



^^^11 Carriage Return 

Tn the Autostart Monitor, the COUTZ routine t^nl Is (J 
which handT.es the control-S function before jumping ^ 

Thf- COUTZ routine in the Old Monitor calls VXDOUT- 





entry la otlier than a control-C, the keyboard strobe is c 
Otherwise the keyboard is left filled with the control-C 
r^jUlng program to detect and handle- Then. VIBW AIT JMP'fi. te. 
VTDnClT. 



l.inc Feed 



Tlie cursor is iroved down one line unless this would put it on a 
lin^ below tbe Scroll Window- In that case, the contents d£ thfi 



fifta^'i'butlne TfHJves the cursor t6 the lef^t one space by 
deereinentlng CH. If CH goes negative It is set to CWNDWDTH)-! 
V.V la decremented. If docrementln;- CV would take It above (W 
CV is not decremented. Negative scroll is not supported. 



P'7 Sound the Bell 

, -Other character In the range 38fl thru $9T is ^P^^t^dt* 3^-^^^ 
TVQt; ^-ause cvirsor mot-loti or neniCiry tnodlf lcation< 

0OTPUT WITHOUT THE SCROLL WINDOW 

II >i\ \ 1 M" pii r L of the reen is to be used in a di rect add r ess 1 ng 
iiuHini'i , It [:. necessary to avoid certain Ilonicor services. In general, 
I lu' i^rriiM Window s*?rvices provided by the flonitor are: 



I. Srrolt all text in the window up one line it a carriage return 




3. Place the cursor at th*? left edge of the Scroll Window Insfe 
of at the left edge of the screen on a carriage return. 



-.-.----a 



A, Support screen clear functions: 

A. Clear the window, place cursor at tcm 



cfirner 



^^ttsmatlc eervleefl neefl he au-olded- 

Tf the full screen is to be used as a raii(iom aceess display, vlthout a 
■pprtlon. heing used as a working Scroll W^TiidCf^j. pxohlen^ la not too 



1, 



The scroll opotatloa only occurs if a carriage return or line 
feed or exceeding ^ad.ow width occurs on the hotLtdm line of the 
Scroll Window.-. feoM. this by not haying the pro^r^ output CR 



keyboard input operations. 



2- The full screen is defined as the Scroll Ulndow by the Monitor 
when the RESET key is pressed • A user program can restore the 
window parameters to this configuration if they have been 
altered by calling '"Set JJormal Scroll Window" at $FB3C or 64316 
or -1223. 




i string of characters moans as if 

I services, ^^ing c^^^ m ^^'^-^"tlDtiaXlj^ 



-'r"£' 



f^Jote that program output of a carriage return does not clear the line 
to the right of the carriage return, but keyboard input of a carriage 



One way to sopport a divided seTeen Is by usirtg the Scroll ^ti3m? feK 
data input vri th the Monitor ge.t-lnput-Ilne services, and by using the 
Scroll Window support for whatever output the prograin intends to put 
there. Then use parts of M^^S graphics, support for placing characters 



1^ 



here is to leave support of cursor position (zero page fields GV, 
<i\, ,'ind llASL^n) up to the Monitor, and use other methods/fields for 
i» 1 ,K- i iig characters outside the Scroll Ulndow* 



To place charact^i^&i oot'.a^to; ^JjiB: Scroll WinteBtfj 




'i^. m^'t^^ ■mmm'i^^^ m^^^ i^msm.4^'m-\m^f>mm -m 

does not interfere with LORES plotting If tt» 

j-u rocn is being used in mixed mode, because PLOT calls always set 
JillASh,ll as required without regard to possible previous contents. 



Another approach Is available for the BASIC or APPLESOFT programmert 
v^i^^in, the Scroll Window support can be used for some thlTiga, i^lle 

t'he following 3.pprfiach can be used to place characters on the screen 
iiutslde of the window. That approach Is to compute the screen memory 
litc'itlon for each byte to the screen, and poke the byte there. A 
v.irlatlon on that approach Is shown by the sample program. In the 
!jiMii|)le, the Monitor VTAB routine is used to assist in building a table 
1(1 inciflory locations Indicating the starting points of the screen 
I hujs. This is an easier alternative than using the modulo arithmetic 

hinnula described in the section "Pages Four thru Eleven". Hote that 



Ifex +Dec -Dec Monitor Register^: 
Addr Addr Addr Label Destroyed 



fHfTs I iH': or scroll window 

i;<>iii|iute mtmory address for Hne in F847 63559 -1977 GBASCALC A 
A-reg; set flBAfiT.^M, 



IHSIDR SCROLL WINDOW 

not irJVFhc. 

ri r Scroll Window to blant^^-^ 
cursor to top left c^rit^rT> 

m -^t^^ ^^vie^f^ ^^!^. ^'lA^ ^fe 




Um i^^^''^"'i'lne im col 
CV aM BASL,H from 



^^"^f^,lT from CV (and WHDLPf:|>* 
BASL,H from 
without regard to CV, 

Set BASL,H to left end of screen 
line (not window line) in A-reg- 



Hex +Dec -Dec Monitor Registers 
Mdr Addr Addr Latfel Itestrq^ed 








36 


S24 


WNDLFT 


32 


$20 


37 


525 


WNDWDTH 


33 


$21 


38-39 


S26-27 


WKDTOP 


34 


$22 








35 


523 





10 

11 

12 

1010 

1199 

I 

IF 

I23i? 
1235 
1333 
1399 

J5M 



1511 

1519 

1520 



1601 
1700 
1723 
1743 
1B00 




RM TT^.XT OUTPITT UITHOlIT THE SCROLL WINDOW 
REM SAMPLE PR0GRAJ1 

REM READS FROM KRVROARD LINE, DIAR, STRING 
REM AND PLACES T?iE STRIMG THERE 
Rm PROGRAM ENTRY 

DIM L%(23): REK LINE ADDR TABLE 

GOSUB 63303: RT?^ tlAKK UP TABLE 

RSfl PRINT PART OF TAB^S 

PRINT CR TO ALLOW CTL-S STOP 
REM CLEAR SCR^;EN BEFORE QlAN 

REM SET UP NEW WINDOW. 

POKE 32,24: POKE 33,14: POKE 34,12: POKE 35,^ 

CALL -936: REM PUT CURSOR INTO WINDOW ^ftS^V. 

INPUT LI,CL,SS$:REM READ A COMMAND LXNE;. 

a. 

IF SSS = "END" --^-^ 
SL = LEN (SSS) 

m mmm r 

^-nt trnti tm 

IP CL > 39 THES 1B10 

REM NOT PAST 40 
IF CL + SL > 39 TEIEN SL ^ 40 - CL 

RM PUT CIIARACTERS mE 

FOR I = 1 TO 5L 

C$ = MtDS <SS$,I,J)!C% = ASC (CS) 
POKE L%(LI) + CL + I - l,C% + 12H 
NEXT 1 

GOTO 1300: REM GO BACK FOR A^'OTHER COMMAND. 




t 



I 



E 
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Krai T.LME OR CH TOO EiS'- 



]H\l CALL - 936: PRINT "NOT SO flIG" 
I HI 2 

f^'^300 
'M3ltf K% 



REM 

REM MAKE UP 
= mi RK^IEMBER CV 
h 1023 FOR T - TO 23 

i. ^010 POKE 37,1: REM SET CV 

i.ll^n CALL -990: REM CALL \^AR TO FILJ. RASL & BASH 

L%(t>/^^ * ( PEEK (41)) PEEK (^0) 

^10^1'") REM TABLE SETIJP DOHE 

(, 10/|<", 

U ii^')0 POKE 
(►'I3(f0 REXUfltJ. 



SECONDARY C^ISPLAY AREAS 



Tlu> A|iple II hcTrdware allowt. ujie of j^ithor of two neniory arej^K for 
iM:(|iliiy to the Jjcrecn. Ttie first, or priraory. Is memory locations 
',':W''<^3-$37FF< The secondary text (and low resjolitt ion graphics ) di splay 
/ircni Is S3f'33-S0BFF- This area is normally overlaid by a user program 
or djit.a, hut in Hpecia.1 circumstacces a user may desire Lo make use of 
llifH seci^ndary area as a scTeen display atea- 





'['luTc -iro times when it is desirable 

r]ii T rk I V, al t hmi^^h the proj^ram produce 
j\ pT"(.^;v:iiri rnijj.ht display data found by 
prop, rrirni'i'T i>lit 5^enerat e the orlgina 
(!lji;kl,'iy area, tlitn move it to the Sec 
li/irHvnre to display from secondary- 
.gfuet^.rfi tl^ iiext screen data in the 

i^'y the Initial or previous 



-pri^^am -fe pm^t^eti, later ^ibifi &&q 



to chan;^e the display very 
s the output slowly- For exa 

acannlnf^ a disk file* The 
1 ^screen data in the primary 
ondary display area and set the 
The program may then proceed to 
primary area while the Ctpeta^p 

display of results^ A samp^ 
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When the floiiitor places a character in the screen memory area, it does 
so usin^ EASL,H as the address of the tnemory location for Che leEi: evid 
of the line, and (CH) as the displacement: from the left end of tti;e 
line, GASL,H can be initialized ^ memory location of a sel;"^!:^?^ 

screen line by setting tlie des^l^ number In CV and then Q^^lii. 

TABV< On ret^rt^irm- that; -G^^ '^^^ ■4-.tor MSH changes BAS^^ .to 



*i^"wi:lt 1^ ^fe^b^^ ^rttm a Ca^Hage return or writes 



S^haraccere bej^ond the rlgl^t end of the Scroll Window. 

If the Monitor is called upon to read from the keyboard, it "echoes" 
the input characters to the screen. Input of a carriaj^c return, one 
backspace too many, a cursor mcvement , or a screen clearing Escape 
Key function will cause BASL,ll to be restored by the Monitor to point 
wlLliln the primary display area* 




In the case ;*ere one. dlajJ^^^ ^^^^ tS' 
l^^her" for 

j^imary .area^:^ t^-^^e^^- to^^e .^^e^^^ 

text output BASL,H Is re^3^ii£*^ 
cursor to a new line. 




It must be noted that APPLESOFT also does not (easily) support the 

secondary display area. APPLESOFT In RAM occupies that part of memory, 
and then some- Firmware APPLESOFT places the program code in that 

memory space, unless special actions are taken. Those actions may be 

3e APPLESOFT and the secQnda,ry 



^oted In the sample profiraitl;, ^?Ii-fccd 

■ m& ■■If 





Place cursor at line^ 
(store A to CV and 
by JMP to VTAB- 

Set BASL,H from CV and WKDLFT 
by call BASCALC and add WNDLFT. 

Set BASL,H from A-reg and WNDLFT 
by call BASCALC and add WNDLFT^ 

Set BA3L,?I to ir.emory address f^ 
l^ft character of screen (nyC 




FC22 6-^546 -99^ VTAB 
FC24 6454« -9§6 VTABZ 



Hex H-Dec -Dec Monitor Registers 
Addr- J^ddr Addr Label Destroyed 



Wi Uc byte in A-reg to <icrecn at 
rnrsor (CV),CCH) using INVFLO and 
Muijpcirtiiig cursor raove* 

WilLe byte In A-reg to screen at. 

CCV),,(GH) witli. 




routine- (AIL.H) thru ■fa^^^i:!*) 
moved to CA41.,10 thru Wat evft*-.. 





Monitor Command Procesa&C SB. entry. FEB6 

Set PCL,H from AlL,H fig^t^ifeed. fi 

Call RESTORE, set al3 S & FEB9 

JHP via PCL,H. " ■ FEBC 



652^9 
65212 



-327 
-324 



mi 





DIRECT CONTROL ADDRESSES 



The followinR tabic describes the methods of setting the hardware : 

dlsplniy Co vj^rioufi screen configurations by direct control rather 

by railing the Honitoti For some of these items there is no rout^i-j^ 
In the Monitor which t^yld he called to perform the function^ 



Set .GRAPHICS display node* 
,^et TFXT display mode. 
Sec Graphics mode to Full 
>S*»t MIXED GRAPHICS and TEXfeiji^fe^ 
Si't dieplay to Primary Page. 
Set tlisplay to Secondary Page^ 
Clf-nr illRtlS = Set LORES mode- 

•Art JUHES Graphics mode. 

Sot top line of Scroll Window. 

Sat left edge; of ^rol.l iiinslccw. 



POKE 


-16304,0 


or 




POKE 


-163^*3,0 


or 


STA 


POKE 


-16302,0 


or 


STA C052 


JOKE 


-16301,0 


or 


STA C053 


POKE 


-16300,0 


or 


STA C054 


POKE 


-16299^0 


or 


STA a/^bb 


POKE 


-16296,0 


or 


STA C056 


POKE 


-16297,0 


or 


STA C057 



POKE 34, line-number (0-23) 
Bottom must be greater than to^' 
POKE 3 2, column-number (0-39) 

«iS^^-TWt to exceed 40* 
i^^j^im^^^coiumna (1-40)^. 

tef t edge + width not m 
^KE 35,llne-nnm.ber (L-i^l 
Bottom must be greater 



r;ii 

i;v 

(;kas!,ji 

BAiiL.H 



i6 

37 

38-39 



$24 


WNOLFT 


32 


&20 


$2 5 


WHDWDTH 


33 


S21 


S26-27 


WNDTOP 


34 


$22 




WINlJbTH 


35 


$23 



10 Rm SAMPLE SECONDARY DISPLAY WAY 

11 REM USING KONITOR MOVE TECHNIQUE 



20 RETI MOVT'. AREA 1 TO ARF.A 2 

21 POKE 60,0: POKE 61, REM SET A1L,H 

22 POKE 62,255: POKE 63,7: REM SET A2L,H 

23 POKE 66,0: FOK^ M^Bi- REM SKT AAI,H. 

25 POKE 71,0: RR1 SET Y-J 

2 6 POKE 5^,y\\i 

27 POKE 59 

28 CALI. -3 

29 RE^ 




1(J0(J EEM PROCRAM START 

1091 IF PEEK (75KiS:,m^^W 



lia<^ GAIL -936: 



KEM CLEAR THE SCREKH 



120t* PRINT "THIS IS THE SECONDARY DZSPLAY 
1210 PItINT ^'tJOTB THE lACK CF CURSOR" 





^^T fiKGONUARY 



15^^ POKE -16299, 

FOR I-i TO 4030: NESft" t 
170(J POKE -i63«0,0; RKM BACK TO RtMU^Y 

18<3y END 



32W 

320fll PRITJT "K 

320^^2 PRINT " 

32003 KND 



REM NO LOMEM ERROR 




APPLESOFT SAMPLE PROGRAM 



14 



SftEfFlE PROGRAM 
REM READS FROM KEYBOARD 
REM COMMAND, TJNE, CHARACTER. STRING 
REM AND PLACES THE 



100^ 



Rm PROCR^in FMHRY 



m9 

1010 IF 



REM IS SECONDARY AREA CLEA^: 
PEEK (104) < 12 THE?J 62000 



1309 

ni0 



1410 

I ^n^^ 

1431 
1 4^)0 



niz 
i6iy 

1 700 

1 ;i0 

I HI0 

u;i I 
ia:^0 



RFj-t M A I H 
IF q = ^ TtlEN 135:0,; 

POKE ^^5;^,^2^i: ^^ 



PROGRAM 




INPUT CCS,LI,CL,SSS 

IF CCS 



IF CCS 
IF CCS 



"E^3D^' THEN 63900 



IF 
IF 



CCS 
CCS 



"P" 



IF CC$ 



TJIEM 2lfl(^ 
riLEH 22^0 
^■R" THEN 23a^J 



REM SET SHOW TO SECOMJARY ARJCA 

REM SET SHOW TO PRIMARY 

REM SET INPUT SECONDARY 

RETI SET INPUT PRIMARY 



POKE 163W,0: 

■Si - (sss) 

|f I .■23 THEN 1810 

^ > 39 THEN IS]0 
IF CL SL > -19 THEM r>!. 
CX = PEEK (37): 
POKE 37, LI: CALL - 990: 
POKF 37,CXr 
POKE 36, CL: 

SP$ = LEFTS (SSS,SL): 

J'RII^T SPS 

GOTO 1300 
CALL - 936: 

PHINT "NOT 

J'laNr "LN '^^i^- 

COTO 1300 



' mm 




= 43 - CL: RE^^ NO 

REM REMEMBER CV 

POKE 41, PEEK <4i) + 4 

REM RESTORE CV 

REfT SET CH FOP THIS PRINT 

REM SHORTEN PRINT IN THIS SMPL 



REM VALUE TOO URGE, 




POKE - J6^tfi§!: 
.t^jTO 13(J0 

f^KE - 16300,0: 
GOTO 1300 

0=1; GOTO 1300: 



J-. . -.-fj- 



REM SET INPUT TO SECONDARY 



62^19 

■13305 
63010 

63023 
63033 

63043 
63050 
63^f60 



PRINT "SETUP NOT tlADE, NOW BHIHG DO^ 
PKIWT "RUN TlJE PROGRAM AGAlf."' 

REM 134 IS APPLESOFT ROEt.i^ 
RFJ1 BYTE BEFORE SC0I WUST 
POKE 3072,(3: POKE l^k^^lZ', 1^0 




FOR I - 1 TO ,3:BL^ 

CX = PEEK (37) 
FOR T = 3 TO 23 

POKE 37,1; C^^% 
POKE 41, PKEK#ft''*% 
POKE 36,0 
PRINT ELS 
NEXT 

?OKE 37, CX: POKR 36^0 




AREA 




INTERRUPT PROCESSING 



mo romini h t^rij are capable of reacting to the raising {or dropping) of 

.1 Ri^^nnTl liriQ by instanLly saving the current ststiifi of the proce5isor, 

^md quickly trans.'Grrina control to ^lODie other program ulthin ihe 
c'lmpntor. Chan^^n^ the state of that line is called "causing an 

Int^-rnipc"- The functions of the processor In saving its current state 
i\v\<\ transferriiiR control to some other %tt '^0^^^/^:-^^^^^ 

"cnkln^ an Interrupt". The program whii^' tfefiii 'Eel^^^^e^e 
<-Wpeottd to "handle the Interrupt"- 



6502 microprocessor in the Apple II is sensitive to three 





Till! purpose of an interrupt, in general, is to allow some kind of 
f'xf.t.>riial device to make a condition known to a running proi^rain without 
I Itr pi OK ram having to periodically or continually test for the 

li.i rilwnTre cordltion. An example of the latter type of operation is tlJi% 
Apple TI keyboard operation. When keyboard input is to be accepted 

rm-tiinry locfltion $0030 is tested repeatedly until presence of t^^^B^ 

Indicates that a key has bfcen pressed- An example of IntJ 
drtvfn processing could be a special peripheral con t rolled 

ntt^iiihed to a telephone line, which caused the Computer 
f-urr by a data acquisition program any time data was ayf^^S^P^^^ A 

t¥^rf>ito«^f^tt^t.tM^^i^ - - - - ■■ ■ ■■ 




an 



^.^cessor st^itus in 
tese^f^pted program Ci.n be ^^^J^^: f^)^ 
been "serviced" or handl^*; 




Prc!veiit further tec 




im t% Apple II variations on the above three steps are 
U^san i£i5HF th^ three different interrupt classes or categorfes- 

]. When an IK<J (or 6RK) or NMI interrupt is taken, the contents of 
tin? proj^rmn counter and the P^reg (processor status register) 
ifV'} respectively nuslied onto the stack. Wlien a RK3KT interru^ 
te tiken, the processor holds the memory in READ mode until 




^. ?M'i"terrupt, the P-reg Is ^nodlfled. U 

-a BRK f net met ion. is executed, ttie bit of the .g^Oc-efafl*it 

status register is set to cnA^'^^^ m M "^^M . , 

the stack- If the IRQ line wfifi^ ^'Slte ^saaee^^ 'iCW -^^^^r^fei tWk 
bit is set to zero before the P-reg la pushed onto tliG stack. 

After the P-reg 1g pushed ontp t>e stac^?, the $5*4 bit IB set &jcj 
With RESET and NHt. |g ^S^^^^(^ 

preventing another" iT^^-^^i'-^iftSfe ^^e^fc Si 

^h-'i'S^i- rfUmi'^^ (^fiirtC^ m. ^ appropriate program for 
handling an interrupt by means of "Vectors"- Memory addressee 
$1-FFA-SFFFF are reserved for this purpose. The final step of 
takinj^ an inti?rnLpt is loading of tlie pTOgrjiri c6unter frOin^ t 

two tlonJ tors - 



interrupt Vector 

Address 



Monitor Old Monitor Autostart 
Label Address Address 







$03FB 





te: ^iiitor does not interfere with user handling of 

^]tot- That la, the vector for NMI causes the 65^2 

I, ,^^er^ 




this type of interrupt 



RESET INTERRUPT SUPPORT 



ng the RESET key on the keyboard causes a RESET interrupt 

to occur- On all Apple II's but the very early ones, power-on 
als3 results in generation of a RESET interrupt. 



The actions performed by thp Auto&>tart tlonltor and the Dl^' 




,54 MONITORS PEEL£Q 





instruction i®: 
The CQi 

2^, MW. ^ A-E^ 




,^^n sets the bit oY the P-reg, preventing another 
■ifearrupt of this type from beln^ recognized until this one Is 
"handled. The ^502 then loads the Program Counter from the IRQ 
hardware prcsorihetT vector at SFFFE-SFFFF » and alXp^m ^frEKfc^ni 
of Llis? computer to continue from that point- Thg; ^ 
Handler for IRQ Interrupts is now In control. 



RE$^ IMTERRUPT-OLD MONITOR 



the Old Monitor eatabllshea a 
^Sic^^'^'fea^^are and page zero fields. Primarily, 

tcput device, the screen is set aa 




Vi\}\L^ ^ero fields KSWL^II, CSWL,H are set to make thp keyboard and 
Nrrot^n active, WNDLFT, ^JNDWDTH, UNDTOP, WNDBTM are set to define tft^ 
wtiole screen aa the Scroll Window, CV and CH are set to place the 



-/I 



- clear high resolutl?Wi-„-gpB 
'M'M'^^ - di^iplgy primary area 
r^-.^'ll - set text mode 



CiMUroI fK then transferred to the "top*' of the Monitor at label MON^ 



A^r Addr AdHr Label Destroyed 



Set STATUS in % & FSJF" 

Clear HIRES- ■ ^ p^^^ 

Set pritiary display area, & Y^36 

Set TEXT mode- & FB39 
Set full screen scroll window by FB3C 

htanch to SETWND with (A)=0. 

Set WNDTOP froTD A-reg- £ FB4B 

Load A with for WNDLFT. & FB4D 

Set WNDLFT from A-reg< & FB-^iF 

Load A with 40 f:t>r WtUJWDTK. S FB51 

Set WBWBTH from A-reg. & 

Load A with 24 for WNI3BT^^^, Jfi 
Set WNDBTM from A-ref,- S 

Load A with 23 for CV- & 

Set CV from A-reg. £ 
JMP to VTAB to set BASL,H & RTS. 
Set INVFLG to SFF - normal video- 
Set INVFLG from Y-reg , 
Set port (keyboard) for Input. 

Set port (screen) for output- 



FB5B 
FR3D 
FE84 

FK86 
FE89 

FF93 



Hfinitor entry on RESET key pressed 
or Power on- 

,Call SETtJQRtJ - white on black. fi 

Call INIT -Text & full scroll- S 

paJ-l SETVID - screen as output, k 

Call SETKBD - keyboard = input, f. 

Clear 6502 decimal mode (set hex) & 

Sound bell. 6 
Monitor Coraoiand Processor Entry* 



FK59 



FF5C 
FF5P 

FF62 
FF65 

FF6& 
FF69 







INIT 


A 


643^7 


-1229 




A 




-1226 




A 




1 T 1 1 
"1 


bEiTXT 


A 


□ S _j 1 D 






A 
rt 




"1 J 


bhlWND 


A 


64333 


-12tfli 






64335 








64337 


-113^5^ 




t 
















1 


b4 345 






A 


64347 




TABV 


A 




1 1 Q "7 




A 


D J 1 jO 


_> OtfJ 


jEt 1 j^l^ pj L 


7 

X 


loo 


"7 Q 


br^i LV Hp 


none 






L? Tj 1 J\ D 1 ' 


A y Y 


£[1171 


'I dl c 

"->6j 






65369 


-167 






&5372 


-I6i. 






65375 


-161 






65376 


-15R 






65381 


-155 


HON 




65382 


-U4 






65385 


-151 










MONITdt 



Autostart tlonitor performB 
l^ftldling a RESET interrupt, 

li. Establish a known Lardwa^j 
the basic machine. 



--i-.-J tT' 



11: the contents of memory (p3ge three) do not indicate that a 

pouer-on initialization has been performed, nhe Autostart 

l^tHilEojr K^ll perform power-on initializatl.'>n< if a -disk 
^^X'^'X^^ card is preaen!: in one of the slotsi- ^wer^on 

i^^^i^mi-ati includes baRt^str^plng. txm- 't^' "^fl^i^^- ^ 



.^Ceiws conurol at the end f>f power-on Initialization, with 
,j*^^^Iitir^e--fi.ei4f*,*^^ to. in^t.c^t'^^ that .a ^^^stai?t 4:B- kQ. 



3- If the contents Of raedory (page t^ree) Indicate that power-on 
Initialization, has already been perfornned, the Aiatostart 

Konftor will transfer control via Che RESET (Soft Entry) vector 

in page three at trie conclusion of "handllnp/' tbe RKSET 
interrupt- Tf DOS haj^ been booted, this will result in transfer 

of control back to the current language processor through DOS- 

If DOS is not present^ '.t^ ^^g&g^^. j^.. t%(^.^}^K^ ^^^or 

will raiisp ^slrailatioa ^ a m( ^^-^-^^^ .^-l...^^* ^^.^ ^..^^ 



INITIALIZE SYSTEM CONFIGURATION 

UTln'ii .1 RI'.SKT ifiterrupt is taken, the Autostart Monitor estahHshes a 
pti'dcl 1 ne<l cojif Is^urat inn of hardware and page zero fields- Primarily, 

-ly^ll^ard is sec as the current input d'evlce, ^t^P»/.i^ ^ 

tiW ^i^r^ent output device, and the screen configw'^S^^ ^ 'a^; 
mr&^ ^r^ll WlufiQw '^rf.th tiorsia.1 -^^f 

'P^fl^ 40:kis ft^iify s^- ^ -Wfe the kiey&Eiiird 

nvrot-n active. WNJlLFT, WKDWDTH, HUDTOP, l'JNOBT^^ are sec to define 
^hnU^ Hcreen as the Scroll Window. CV and CH are set to place the 
I iirnikr at the bottom left corner of the screen* INVFLG Is set to 
inH Jii;i I (wh 1 ce on black) - 

l1n rdw.i i-< addresses are referenced to establish a known configuration 
Ji n 1 1 1 ] [ ow . 

- clear high resolution graphic? 

■^m^- -T =£iei>r AN(a = f% 

- set ml = TTL Tfr 
f^l'.^SV - set AMI = TIL HT 

^Cri'l' - rurr^ i-^ff Hxpanston ROM 

- i:Iear keyboard strobe 



COLD/WARM DETERMINATION 



Alfj'i i-'-l lU f I I nv, .'1 known basic hardware and software (screen 

riinMnlhj) f LL\' J r ^niri'ciL , tlie Autostart Monitor executes a test to 
Hci I'tm I iir whi I Im'I power— qm initialization Is to be perf^^^i^*; 
Mir-'i' l[if:ir iniLs ^'^^\•2-$^'iF3 contain the flESET (Soft Eii^fi:^ ^^^^^.^ -^i 




validation byte, used with to iridicate whether or not power-on 

t^tl^Iis^ation is £.0 be perfprmEd- If the EKclusive OR of tbe contents 

considered a valid address to which 0"^cS^^ 



POWI^ON INITIALIZATION 



functions of power-ori lnlti3iis£^^ ^tt Gi^^t^l** Jft 
page tliree (S03F0-5tfl3F4) the BRK interrupt sector (see "BRK 
Instruction Handling - Autostart Monitor") an<i che RESET Soft Entry 
Interrupt uectoc with validation byte. T^e RESET vector at this point 




Tb< 



Autostact tlpnit^ .^^^^ "^^rforms 



f roiP slot 7 through 5^ Eor presence of a disk controller caEiJi* 



;i routine which tests Gai^lr ^Ifjt,. 

a 

;rf one ia fonnd, a :^imp Is parfomtd to $CX0jJ where X is the slot; 

Huirib^^r In vd^li^h the digk controller has been fou^nd* Hilg will reiei^lj& 
in loading of DOS and presumably execution of the HELLO prograra* 

Note: DOS 3,2 Replaces? the RESET vector at SO3F2-$03f3 aJ^i ^^itg^a^i^ 

byte at 50 that on a KESET Interrupt, control M ^dt#e^: 

throuj^b DOS back to the current langujr^e processor. 



If no disk controller card is found the Ai.it05tart Konitor changes the 
KESKT vector t^^^^J3!^ Clan^uage resta^^^ or Lontr!>l-C entr^ point) and 



SYSTEM RESTART 

Tf the $03F3-S03F4 test described above Is passed, the RESET vector et 
5^3F2''S03F3 is considered mostly valid- Tf it contains it is 

changed to $E8^3 and then BASIC la entered at $K000. If It ie not 





The RESET vector !!iay be modified by user or program to send control 
some other add res s in the jiiach iiie sit the copip t PC i on of Moni cor 
handling of the interrupt. For exatiple, to cause the RESET key to 



to 



19 POKE 1(^10,11^5 
POICE mi, 255 





■Hie following program is WOre gefmm^^ ^^^^4 m'di^ to set Che 

Klo^lKT vector to some atJdresE, poke t^e address l^^to locuMiGJm i^M"- 
Hflll C$03FZ-$(a3F3) and then CALL Autostart Moniuor label S] " " 
(^I'HtF or o4367 or -1169) to eet iQcdctetE. I0l2 C$03F4)- 

m\ IS ADDRESS OF 
I J KKK ROUTlNy^ TO RECEIVE 

1/ KI:m CdNTROL .VPTRR RESET 
.-'W 1310, Art; REM SET LO BYTE 

\^ l>()K>: 1011,A1>/Z56; mi SE.T HI 



Kfttf?: 1^ you try tc run this on a system ijlth an Old H(;nitor ROM, you 
vnfiv <\Gstvoy the program, or even, tbe entire tliskette- To avoid this 
prtjbl*^. CKSCUte St^p^ i]X tKe ^^ye pro^rairi manually, 





rifin 1 1 uc entry on 
iH" !'iiwfr on, 
r.l.O - clear 6502 dec, (set hex). 6, 
C.nW .SETNOm - uhite on black.. & 
Cnll rs^lT - Text, full scroll, & 

SKTVIT) - screen aa Output* 
CjtI I Si'TKBD - keyboard as input £ 

InM [7ili:.ss& ■baa^tMfl^iE^/ known state, 

rAi-nT 'm'i "to La ^ref, C05A). & 
S. ( m-J to TtL HI Cref. & 
:;.^r Arf3 to TTI- riT Ccet". C05F), ^ 
' l-'Jir r:Kp;msii>n ROil (ref- CFFF). 
I ! t I M F k'' vbo 



^ec Monitor Registers 
i^^r Label Destroyed 

- • - • ■ ■ 11; 



FA63 
FA66 
FA69 
FA6C 
FA6F 

FA72 
fA75 
FA78 
FA7K 
FA7K 
FA81 



6-^102 

641^8 
111 



■1437 
■1434 
4431 
-J 428 





(■■■I I ( iiMf,;,, 

■IWt S>-3 VP, ^m,<^*»^ 
I r lAfid ;^ot<i refepV 

M fS3Fl> XOR fS3F4) = $A5, Warm 

l^ffFTKV ($3F2.) low byre: 
N'm-ziTM irnsmFi Cold Start done - 
C'lli. NOh'lX In 'LSI' SOFTFV vector 

y.i - 1 n HUM KM r<'i-!L Ji r I mi nnybc . 
Ti'i;r :;nFTi':V li i for $r:« - lanj^uage 
• fU.mI entry. If not equal, 

Surri'V In ..k Lo MHO, goto NOFIX, 

,s<iF'n.:v - t^hans^ to $E0(^3 for ^Ma ■■&%S5 ^iMl- im^M- 

-Html t^itt ^jtitiitffl^:. 



FA94 64148 -1389 



Hex 
Addc 



Addr 



-Dec 
Addr 



Label Destn^jfed 





^ the Soft 'Rnti^- 

put title Oti tap llij-e, & 
Set page 3 interrupt vectors for 
BRK (OLDBRK) and ^iOFTEV iSE^f^i^) , 

tiook for diHk controller card In 
.^l.OCs 7 thru 1. If none, goto 
^ISSEV above to set SOFTEV for 
■|-A3IC restart & e«fe« =-^^1^^'^ 
If disk found, Jf#':i^J 
the disk. 

screen (call HOMEJ, fi 
Apple T1 legend on top line. 
Set PWaEDUP C$3F4), - XpR .JAS 

'Set STATUS In 'mm -fee^ 

Clear HIRES, 

Set primary diiiulay area. 

Set TEXT mode. 
Set fvill Rcre<?n scrolT window by 

broncli to SETVh'ND with CA)=0, 

Sot IJNDTOP '^rom A-rej^, 

Lo£id A with for WNDLFT. & 

Set mDLFT froin A-re^f- ^ 

Load A with i0 for IJNDVH)^' ^ 
Set WNmJTlTH fi-OTi A-reR. " ^ 

A with ?i for WfjTJB^. ■£ 

^ i^RDBm from A-rs^. S 

load A with 23 for CV. & 

Sat GV from A-reg. & 

Jump Co VTAB to set BASL,H 5 RTS. 
%t INVFJiG to ?FF =^ normal video. 
Set INVFLg from Y-reg . 
Set port 3 (keyboard) for Input. 
Set port Q (screi^n) for output- 




1^': -^10 --^xm -mmm 



FE6(^ 
FB6F 




FF14B 
FR4D 
FB4F 

FE51 
FB53 

FB57 
FB59 
FB5]i 

Ffl5D 



FE93 



64332 
64355 
643S7 




o4331 
64333 

64335 

64337 
64339 

64345 

64:349 



-1184 

-118L 
-11&9 



APPLE II 



I 




SETVHD 





A 
A 
A 

A 
A 

A. 
I 




FOR COMPATIBILITY WITH OLD MONITOR FF59 65369 -lf>7 
xcs^^tne? is ■sG^ttl here. 

f e'St?! detiiTn^rrab'de.set hex. -f. FF65 65«: 

' bell, & FFfi6 653^; 7^0_ 

^^JT Coiiiraand Parqcess^jr Entry. FF69 -^Ji 



OLDRST 





IRQ/BRK INrrlffRUPTS 



IRQ/BRK INTERRUPT RECOGNITION 



IJIk'ii eith.?r aii IRQ interrupt is taken or a BRK Instruction Is e>:ecuted 
1 III.' 65^2 performs au intezrrupt sequence. The contents of the program 

rnunCcjr are pushed onto the stack. The $10 bit of the P-reg is set ^ 
I lufiied in indication cf IRQ line vs. liRK instruction, and then It 
])iished onto the stack. The 6502 then sets the $0^ bit of P-reg , 
lircuenttng another interrupt Of this type from bein^ recognized until 
thtfl one Is handled. The 65l?2 j:hen loads the Program Counter from the 
1^ tard^J^Sire px^sc^ihfi'd Vect^^.r ^ .^^jr.^.g-SFFFF, ^nd, allo>^^ ^»P?.^3tl.on of 



im^lHlERRUPT HAHfiilN^ 

'['hp .■a^zlfc^tinK vector at SFFFE-SFFFF points to ^Tonitor program 

f^v^ toth the Old Plonltor and the Autostart tlonltor. It vrlXJ 

h'Q i^^^ ^dre^a table th^i.t ^he ^^dresa is ^^^|.erent.^ ;h.9.:^:ey.)^*; 

t'lifitpnta of the A-reg are stored at ACC ($45) for future reference* 

Thi? prtjceaaor status (P-reg) pushed onto the stack by the taking of 
Mir interrupt is popped Into the A-reg^ and then pushed back onto the 

■ir.nk ,-;o rh.it Llie stack and pointer are not changed* By shifting the 

A-ii'^i, I et I three bits, the IkQ routine moves into the sign bit the bit 

wh 1 1 h JinficJites (in this case tiy being a zero) that the interrupt is 

ni I lU^ interrupt rather than executJon of a BRK instruction. The 

llijiillifi" then executes a Jump Indirect iastruction via location 503FE- 
i]''F to the user provided IRQ Interrupt Handler. Hole that on an IRQ 

itrt^j^c^fttji^t the X, y, and S registers ar** ^k: .fe 
Mfio, etie interrupt handler has the re; 
h[( ill! -'xU to allow further interrupts*. 




BRK INSTRUCTION INTERRUPT 

I'lur-iulion fi ff liRK inKtruction causes tbe 65^2 to simulate an , 
lnt(?rr^pl with minor changes- Due Co the method the iostructlali '48. 

f^r'fini* pushiriR tbe P— ref- onto the stack, the $1^4 bit Is set to 

IriiMi'ji!." lo the Interrupt handling routine that the cause of tbe 

i 111 I't riii'l vj.is oserution of a BRK instruction rather than the IRQ liEtlffil'- 

inir^hlnj', ibc P-reg onto the stack, the $04 bit is s^t to lnhl*^% 

\\<i.f I II t !■ r I'l I p r s f T on hel ng recognl ^ed unC 11 the interrupt handler 

I'ltnirri roml i [ i-ui. Control is then transferred according to the 

h'sW^ iH[} fnlrTrnpi vector to Monitor label IRQ. As described above 

ii'M^irdiiiK hjiiulliufc^ of an IRQ interrupt, the IRQ routine first atorea 
I hr A*-Tcit rtt ACX ($45) for future reference, and then uSos the A-reg 
III ti'Hi. the Htaeked P-reg contents for a one in tbe $10 position. The 



of the. teJit Is a trsnefer of control to Mofiltor label RREAK- MotL- In 
the address tabl^ that the address of BRE!AK Is not chs sanie in the two 



BRK INSTRUCTION-SAVING OF STATUS 

In each Monitor the first thing dont^ in the BRF.AK routine is to Efavo 
full nxachJne statuj; in page sero. The contents of the A-reg have 
already bp.en stored by er.try into the l^q interrupt handler- Th<! MKA^ 
rontlne pops the stackej^ contents of the. P-reg from the stack, and 

does a JSR to SAVl at which point the remaininj* registers are saved- 
Note that this clears the $0^ bit, allowing further IRQ or BRK 
interrupts to he taken- lli*? S-reg saved at that tline, liowever , Ij^, 

lieen Incremented once by popping the P-reg back from the stack . . 
decremented twice by the JSR to SAVI. On return frbra SAVl, the "BffiEM 

tmt^^. %hg ?^5S?'^^ c,pynt.*if tvm w^. -^xm^ it in page 

^TLdlc^tes tli^'.pag^&'^sre-rtt^ Ifcf^ti'c-ift^ "at i^H^i ^"'.^g^'' ate stored. 



BRK INSIfiljaTIO^Nl^QU) MQNITOR 



#^^^i^»K-^3^Wfcra^^fea Interrupt handler of the Old 
^^^l^t^' i^ display through COUT the machine statni> at the time nhe 
^^^tefiast^^^ti^oQ was encountered, and then return control to the top of 
ttle Monttf^r at label MON- The det.iils above describe the handling; of 
the Interrupt through storage of machine status In page zero. 
Including ?CL,IU The Old Monitor BRF.AK routine nest does a JfiR to 
mSDSl to display the Instruction at the address indicated by PCL-PCIi 
(which Is two Ijytcs beyond the BRK executed), and a JSR to HCDSPl tt> 
dlspl^iy the contents of the five registers, P, A, X, Y, S- Hote that 
the E-rep; as displayed Is two less than it was at the time of the BR^ 





the Autostart HonJtaE ^imtajt:^ IRQ fnterrui^ which te real If 
i^sccuction Interrupt s^Wug registers and Pragram Counter & ^SE^, 
zero locations- The Antostart ttonltor BR^iAK routine Chen exits via ttjij 
^pple-II BREAK vector at Thus, It is possible for a user 

.^ograra to gain control at thst point and do something other than to 
i^laplsy the registers and return to the Honlt or command processor » 
fech a program inust be sure to clear the $04 bit in the ?-reg on 
return. During RESET interrupt handling for powet-on, this vector Is 
initialised to point at Aiitostart Monitor label OLDbl^K, which routine 
does i.he same thinj^ as was done in Old Monitor- That is, it does a J.'^K 
to INSDSl to display the disassembled instruction at the location 
indicated by FCL" PCH, a JSR to RCDSPl no display the regis^¥f^ 
contents, and a JMP to HON to complete the handling of the 3 



Note; afteir DOS 3-2 has destroyed page 3 durlne Che h^¥#^Bft 



Hex 
Addr 



+Dec 
Addr 



-Uec Monitor Registers 
Addr Label Destroyed 



Disassemble the Instruction 
CPCLJI), print thru C0!1T- 

[Jisplay regJstErs thru COUT from FAD7 

save area, after carriage return- 
Display registers thru COUT fri>Tu FADA 
save a rea - 

Save h5(^2 rtgs at $45-49, i'F4^. 
Save A-reg at ACC $45- 
Save X-reg at XRf:G $46. |' 

Save r-reg at YREG $47. ^ 
Save P-reg at STATUS $48, & FK^ 

Save S-reg at 3PNT $49, A FF5i 

Clear 654^2 decimal mode (set hex)- 
Clear 6502. decimal mode (set hex) & FF65 

Sound bell. s FF6fi 

Monitor Command Processor Entry. FF69 
Set as pronfpt character, 

AflTOSTART IRQ/BRK flANDLING 

UeLerinln^? whether Interrupt was 
IRQ or BRK, transfer control 

accordingly - 
Handle SRK ip^^^^^f 

JMP (BRKV) to possibly user 

specified routine (noraaj-ly. t<i 
■QLDBRK, below), 

5'^ult BRK Interrupt hm^M ^m^^- ^ 

iS^pletton routine 



64215 --132] REGDSP 



-1 





65381 -135 MON 

65382 -154 

65385 -151 mm 



A,X 



5421S -13.18 ^p^Pl. 




DeterTTiine 

IRQ or RRKj^ : 

accordingly. 
Hand ] n RRK i nterrupt : 

Savp registers, 

Display Instruction (2 bytes past), 
Dfsplay refiiscers, JMP ^ 



rCL,H 58,59 53A,3B 



I 



•■ ' •• - ^' ■VM/ ^ ^-^M - 



YRBG 
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347 




^ - 



fc: 
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CHAPTER 4 






^ r - J* 





TluTe are ina:iy roEitlnes in the. HonltoC which can he helpful wlJen 
Ji'vt'l op ini= loachine language progranis. Some of these are routines 
iiHr-J in the finished propjrEim, like the Honitor MOVS ^1 



In UiSg list '^re [^enpral , special, or very special ^iSS^S^r ''^^^'^^ 
routine:;, <int1 some data miiipiilatlon routines- 




Wrilr byte In A to screen at CV,CH, 

I'r i iJi Cfir riaj^e return thru CGUT, 

I'l hu three hlanks tl^ru COUT. 

rrint (X) blanks fcti^ 

I'r [ lit cbaracter 

'S^k^ i££sa&^ PSEU- ^WJ^fc 



FDF.D 
F94R 



or Regiater& 



65005 
63816 




■5n COTIT 
■626 CROUT 
■1720 PRBLNK 



?A 

A 




i'rlnt hex of Y,X cegsV 

Print hex of regai- 

I'r I iiL hex of X-reg . 

I'rlnt tM, then hex of Y,X re^s, 

I lu'n milium sifin (or dash), 

I't inl. IfL'X of Y,X regs J then dash- 

I'rint c:i^ hex of AlH,AiL, and dast^* 

I'l Itit memory as hex with preceedi 
iidffress from miaiam. tc iiimin7 where-. 

f&^fkpira in initial, content of 
E'.j^^Tit memory as hex. fron (i*?^^^ 
llirii (A2L,fO- 



F944 

FD96 

FD99 




-: 




6381 Z 

64918 

64921 

i 



-1728 PSHIYX 

-1727 FSrJTAX 

-1724 PHNTK 

-618 PRYX2 

-615 



IS. 

A 
A 
A 




?':iv<' A,X,Y,P,S rep.s at $45-49. 
$4W.9 ae ^AVE*^ 



FF4A ^5.%^A -182 SAVR 




mm 



MiHlHur CoiiiTiand Proressnr GO entry. FF;B6 

Srr Iv:LJ| from Al].,l[ if entered. 6 
Tall l^l-STOKK, set all re^s but FEE9 
^hini^ via PCLJI. 
ttovt' irkcmiiry contents to (A^i-^ip^j 



65206 
652^^9 



■330 

as? 
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Compare memory contents (A4L,H) 

no <AiL,fr) thru (\2h,U)y print 

diffecencPK thru COUT- 

Increment A4L,H (S42-i3). & FCB4 

Increment AlL,H CS3C"30\ set Carry FCBA 
if A2L,R less Chan AlL,n, 

Set GBASL.H for line (A), ?M7 
Clear A-reg to a nibble, leaving fG?9 
m low nibble ^^K^-:^ 
■entry carry i^^SJ^^^-^ 
ctarry set- 
jemlile the Instruction at 
ijH), print tbm COTJT. 
Ifenpute iPUhM + (LENGTH.), leave 
results in Decimal Made ^*lag 

miist be clear before calling PCADJ. 
Read paddle (X) into (Y-rog). FRlF. 
Wait .01 seconds, Chen sound beJl. FRDD 
Load Y=192 for -1 sec of bell- & FBE2 
Toggle speaker at 1 KHZ for number FUF4 

of cycJes in Y— reg - 
Place characteE^ .^.creen refresh 



Hex +Dec 
Addr Addr 



-Dec Monitor Ref-istor?; 
Addr Label Destroyed 



t<i t:oT> left corner. 
Load 9 into Y, Chen print dash, FD9C 

Print dash thrti COUT- FD9E 
Character print to F>cre<?n output FDF0 

routine entrv - normal for cr?WL, 
Print character to screen ^ji th 
af^proor iat e act ions on cont.ro Is 
jconcral characters* 
ie"^i)<$A0 goto COUTZ, bi^'^ 
Inverse video mask* 

.Monitor entry on ^!S5S^ feey pressed 
or Power on, 

cai 1 sETNosH. ^ m^m m "mm-* & 

Clea-r 6502 dec^^l ■■a^fe ^^t. iKK^:,6 KF65 
Sound bell & FF66 

Monitor Command Processor Entry- FF69 
;>et as prompt character & 

Set (a) aa pronpt character & 
%Onitor Comifiand Processor cOini^J^^ 

pareing rontlTe; save hex dlgi-ts® 
in A2L,H, return with command 
(first non-hex) in A-reg, T-reg 
set for next cliaracter. 

A1L,H 60.61 S3C,3D 
A2L,H 62,63 S^E , 3F 

A3L,K 6A,65 54^,41 



FF&B 



64692 
6469S 

63559 
&3609 



■844 KXTA4 
'838 NXTAl 



A 
A 



1977 GBASCALC A 
■1927 SCmZ A 




-1040 



64386 
64477 
64482 
64484 



'12^0 PREAD 

1C?59 
-1^554 

■1{^52 BELL2 



64924 
64926 



-612 
-610 

-528 COUTl 



65381 
65382 
65383 




-155 M0l3- 
-154 

-151 MON^: 
-U9 



A4L,f[ 66,67 $42,43 
FCLJ! '58,59 S3A.3B 

ACC 69 S45 




74 



A,Y 
A,Y 
A,Y 
A,Y 



FBFD 645j?9 -1027 VIDOUT A,Y 



?A 




LORES PLOTTING 



III si ariHard (or lew resolution) plotting! mode, the graphic art^'r^g^ 
nr j i'i'n is 40 poi nt^i wide cind either 40 points hi^h with 4 lines of 

M'XL below or 48 lines hi^h. The X coordinate is horizontal and the Y 
rrmrdinate Is vertical. The i^ame Tnemory area is u^ed for low 

I'lVio lut ion plotting as ts used for text output to the screen. However, 

In the i;raphics mode, each character position contains information for 

two plot points, one iramediatoly above the Other- Thus, 20 text lines 

itry U). dlS'pJ^y. 40^ graphics IXms % ^.^y Hi- tm^. 

^tit! Monitor contains routines supportirig the foll'6#^^ |i^^=£^^^ 
Set display oiode to rdxed graphics and text- 

:^$;0|iehed mtll anot^xer col-or la Self^dted. 

fl6± a single point Ht ^n indicated vertical /hori^^vnta,! p<3aition- 

iMot a horizoncal ^ "j^J^ ^^f^fe^^^t ^ 
vertical value . 

Plot a vertical ^^:^'^^m^^^^i:^fmXl ^^SM 

^er-tiGsl ^alue* 

#|^tried coordlnate- 

*f1U'ri* .TTa limit at ions on some of these functions wMch may not ali^^^ 
111- Ji L^Irable* For example, using the entry point which sets TiiiKe4 
j:r.ip1^irs and text includes iilearing the graphics part of the screen^ 
ii tPiri}', the Scroll Window to be the entire remainder of the screen, 
.■niil liUhvinji; the cursor (straight down from current p()sltiorL) to the 
h' l ( i^m li SIC of the screen* In addition, chere is no Honitor entry 
imliil. tor netting full Screen graphlcK mode. However, the display mode 
<'oru rols are o^^lf :(M£.« ""ES^^. 

r. \ ori rii^ Into- t^ie= ^;^^^?^^^r^ 01k i^-^-!^mi^^ 



Dec Hex 
Rout ine Addr. Addr , Description 



44 



52c 



is set hy the r.RASCALC routine to the menB^. 
address of the plotting line specified. 



fcantalns the selected color 
Ctd. nibbles of the byte. 



.^^ernally by the plot routines as 
^ ^ eithec the high or low nibble of 

^f^raphics line Is'the top or bfittoni of ti^^ 
displayed from that "text" line- 
is the right end point for horizontal line 
drawlnj*. 

is the bottom end point for vertical line 




Plot a point at line (A) col. (Y^ 

leaving CBASL,FI and MA'^K set- 
Plot a point, line per CHASL^H 
MARK, Goa- In Y. 



(A) from 

right. 

line 

MASK fron 



l^raw horizontal liiie at 

(Y) thru iU?-}, left to 

prau horizontal line at 
indicated by GBASL,H- 

CY) thru CH2>. 
Plot vert ical 1 ine at (Y) from 
(A) thrn CV2), 

Pint ^^ercical Unt? at (Y) froTn 
CA)-hl+carry thru C-^^J.*. , _ 

Plot vortical line sfe 
<A)+1 thru (V2), 

$Xe^F full (^y lines) .screen. 

^lear graphics area C'^t^ lines)- 

^iear ^^t^^jjhi-^ .-^rtial from lint; 

to CV2) ^0 col - wide, 
^jlear ^^i-aphics partial, top left 
lines ^ thru CV2),col. ^ thru (Yj, 



ra 



634H8 -2(^48 



F8t9 635U -2023 



b'832 
F838 



PLOT 
PLCTl 

HLIWR 



63526 -20(^8 VLI-^R 



63342 
63544 



-1998 
-I 9^4 
-1992 



CLRTOP 
CLRSC2 



A 



A 



A,Y 



F826 63526 -201$) VL.IJ^^S ^. 



A,Y 
A,Y 



68 MONITORS PEEk^. 



S< i: I.ORF.S screen to COLOR 

left corner to (Y),CV2). 
I^ntry A-re^ mist be t*, 

Mntry Y-reg = right column.^ 

,S*ft V2 to lafit line to sefe* 
^Sfet COLOR for following poti^& 

Ki-t ^iraphlcs mode to f^^^*. 

j:ii'rir p^r^iphics part of^ S^tee^i* 

to A for WNDTg^.v 
Si .M-f A to tJNDTOP- 

ifi Co A for WNDLFT. 
Sf rjrr A to WTTOLFT- 

Lvnid A for ^-miViet^ 

Sloro A to WDBTtU 

[^luid $17 to A for cy- 

to TARV to set BASL,'!. 



Addr 



-HDec 
Addr 



-Dec Monitor Registers 
Addr Label Destroyed 



^864 63588 -1948 SETCOL 



FB43 

FH46 
FB49 
FB4B 

& FB^D 
S FB4F 

^^^^53 
-4 




6A323 

64326 
64329 

64331 

64333 
64335 

^43 3 7 

64339 

64341 



-1213 

-1210 

-I2t^5 

-1203 
-12(^1 

-1^9 



SETWND 




A 
A 

A 

A 



DATA MANUPILATION FUNCTIONS 



T'Ik th' rivi' 1 nnmbor of routines in the Monitor which rnay be called by 

MiH^'i- proj^'.rains to ^ften needed tasl^s. The routines de^std^e^ ^ 

\\\\}\ Ht?cEton ar^ -;K^^^E^&fleous routines whicti move data f roiri ^-^^ 
.c^tj^:p£ '.'^ inform*! tiqa jjrovide^ tlm FQufc'^^i^ 

Sblfl 'iltlfl^t B^r^: ^^'gfe ^xauline^ -lit t^ife §1^ ^^;^^£©e .ai^. 




IMlemory to Memory Move 

'['lilu roMi hu' f:: its^.'-i i.he Honltor '71^' cominand - As the Coiumand 
[ II f <'i I'l ''f .Mk'n r.lir keybonri"! input, fields Al , ^V2^ and A4 are 
li'j>il''il- IJlu'ii rlir (liiLTUTiijntI Interpreter encounters the "M" it calls label 
'"JVf, , I III! I !■ nM'^f ia Llic table- The crin tents of meTnory fron locations.^ 

JAM I lirii (A?) jirt' moved to Tnemory beginning at location CA4), SeS; .| 
?uiin|il(" tJro)',rJMii En Lfie section "Serondary Display Area Ways and Hea^^ 

^h-^.r MfWi-: Um M?^Jg> ^ri^th Che assi^t^nce Che >bTiitoc Gt? 




The routiT?e in the llonltor which respond*^ to the "0" command uses aiimt 
Monitor routines from BASIC or APPLESOFT in that the register:! are 
loaded from the save area aitd then control is transfer^r^d tte 
location !-peClxled in F'CL^p^ ^^Hi^^: WMSIC program ^t-:^^ 
destination address and rtof^^ ■^^^^pfs., and that] "^^^ .t^. 



Increment Address Fields 



The Monitor t%y^ rotitinc described above Is a s^^i^^(a ^liMet of the 
NXTA4 and NXT]#S, p^M^nee-- JJhen N%TA4 Is called-^ l^^ i^ie.'^ttileiits the cwo 
hyCe field A4l.,t.^giia 't^en falls into label fJXTAt- tSi^tlne at K!<TA1 

increnients the two byre field at A1L,H, and then compares that field 
the tvo byte field A2L,H before retnrning to the calling program- 
fiii return to the calling prnRranij the Carry status bit Is clear If 




l^e SAVE routine Is used hy various other Monitor rouLines to store 
cb.e 65(^2 registers in page ^ero locations $A5"$A9- This roiitine may 
be called by user program under certain conditions - namely, that 
neither the Monitor nor any other program will be calling .SAVE at the 
same time- In Che Old Monitor SAV'E and RESTORE sre used in support of 
Monitor commands S and T, single step and instruction trace. In both 
Monitors, the ^-^^ *^.f^|i3^^ ^.-^/t^E^^m^. <^piU 

sAvi as the A-^^|^ m- '^km^ m pJI ^W-M^' im^- ^ ^ 

processing- 

Restore 6502 Registers 

The routine at label RESTORE Is the inverse of the SAVK roatiiie, 
except that the S-reg is not loaded. In the Old ^ionito^, RESTORE is 
Utilized by instruction step and trace routines before controlled 





Multiply Routine 

f0S..*^E following that the data fields for multiply and divide are 

tn tit*^ satTte format as other multiple byte numbers in the Apple: lowest 
rriFinorv address is least significant byte. 

Set Hnltipller in 




ihf result, in order of most significant to least, Is In $53, $52, 
^M, $5C^. this result la pqeltive. Jf. one of Che two input factors 




NOTK: The table of values above indicates thai: $53,52 should be set 
n> /-'ro before calling multiply. If this is not done, then the initial 
'■■'\\\'-uL^ of this field will be added to the result- For example. If a 
t^tble has an origin of $84W with 7 byte long entries, the address of 



^''x^^^l]pl ok ; 



Called 
Euut ine 



Inputs 
$51 550 $55 $54 



Outputs 

S5'j 552 mk^ 



m 01 

FC 



FF 



m 

PC 



W 

08 

F8 
7F 



7B 

n 

30 

.36 



FF 



31 



08 m 



F8 



7-5 



m 

3F 



w 

m 

20 
FF 




n 00 

ft 

n 00 

01 00 

40 00 



w 
01 

00 
00 
00 
00 



W 

00 



00 
01 



w 

00 



01 

02 
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Divide Four Byte Dividend by Two Byte Divisor 



This routine divides a four hyt(? dividend by a two bit divisor, givinj^ 
a two byte quotient and a tvo byte remainder- It Is avtrllable only in 

the Old Monitor, This routine accomplishes the division of tlie cumber 

byt**fl $53,52,51,53 by the number in bytes $55,54, LeavlEg the 
*fe«4eat in and the remainder in $53,52 im>st sis^Uicant 

® ^le concc^nts of ^53, 52 is larger than the contents of $5Sji^^^ ^S^l^tV 

^^>^^eult will not fit in the quotient bytes - overflow is 
result- The calling program must not let this happen- 

With regards to ecaling, looking at the four byte dividend as ifu 
integer value and the divisor In S55,5^ as en Integer, the quotient; 



^Ign can be a problem if the DIVPM entry point is used- TVve sig^ 
-of the dividend Is the $6fl bit of byte $51- If the intended dlviie-.-i^ 

two bytes (with $53,52 cleared before divide) then signed fleld^^ 

division is supported, J*it^ t'he .tieitig.lj4ie...^M 

call is to DlVP>f, am ^■^^^^^ '^l^ 

before usins them. 



When usinft unsigned divide, entry point DL^;,, 
field by 36 bit field wl.th l6 rejj^ltsi. 




DIV 

f$Fji84] 



0<^ 40 0^ i^i^ 




06 


00 


00 00 


m 


m ^0 08 




m 


02 


00 00 


00 


m ^1 00 0fl 






00 






m n 0(3 03 




00 


H 






m ^0 00 


02 ^0 


00 


18 


00 &f0 




m 0*0 30 00 


20 00 




01 


10 00 


M 


00 00 33 33 


m 22 


0i 


Rl 


00 U 




t^0 10 40 30 


04 00 


04 


10 




00 


30 80 00 


08 00 


04 


10 


00 m 




03 20 00 


w 


04 


0F 


06 90 




00 13^00 




04 




01 00 




30 80 00 0^ 


80 y0 


01 


00 


00 00 




0m mm 


^« 


m 









Establish a RESET Vector 




Autostarr Monitor supports en address vector for 
Handling a RESET interruf^t* It Is trailed the Soft ? 

vee''t«'i'" in- page three. iS' p-biiti^i-ng Hie act^ress 'to tlbU'^^ ^onttol Ta:- 
I(' be transferred after the screen, keyboard, and other bafilc Apple 

li,irdware itens have been set to their 'Mn^tial" states- For example, 
rhe display hardware is set to display prlnnry area text, and the 
Jirr(jll Window full screen values are s^t. 



Aiier eucb initialisation is performed, locations S0^^3 and $03F4 are 
i'"ircd ap.alnst one another to detennlne whetber the vector tn 503F3- 

^o^^K) 3s to be considered valid. If so, control is transferred to 
($03F2-y3F3), Norinally, thl?: reeults in transfer of control to SP',trt03 
to ficcoTiiplish the result t)f entry to the Monitor of a controI-C, re- 

cniry into BASIC or APPLESOFT. During the bootstrap operation, DOS 
JiiMialls its own restart point in this vector. And, of course, you ma;; 

1.0 SL'C sone other- volvic in th^s vectoi", such as thet which will 
r,iii.s- Lht [lonitor (with asterisk prompt) to be called, aa was the 
iinrmal Ciise with the (Ud rionitor. To ^et a different value in that 
vrrtor, 1'OK.E or store the desired value in ?03F2"$03F3 and then CALL 
or JSh to SETPWRC C?FB6F or -1169) to have the Monitor set E)33F4 



Convert Hex Ctosfifers to Value for Use 

l'r.»i;r;ijnnier utility f^fjltrai^a' oetem ni?ed influt ^£ ^i^s m data in hex 
rJt.E:liei^ t'hm %n a^Mitol*^ '^p_ St^al^&r s^^. '^^i '-"^ bex, and 

rhyryt^Ye Ws's ^ ijay of convertiiig ^^^^^^C^ W g value in a 
\ J<Md, The GETMm routine in the Hc^&J^- .feM^t^fit*^ ^rm: Efefl 

L.'Vho.rd tnput .r^a (S0200-S02FF) tWm'MmM^^^m' 
-■'■luUf lonelily !n A1L,H and A3L,11, 

I'iif JlKTPJliri rant inn converts characters in the ?0:00 area beginning at 

■'''^■■*^*^-f-{Y-r^20 and continuinj^ until a character found which is not ^ 

fii'x iHait v^e*, M-.0r :Ar^>i. ^es teat^, in A2L,h (and A1L,H and A3L_H 
II amv:^ - ^) U tho last roifeT^ ^B^ts in th,^ string converted if 
T hi' HI rinft In more than four hex dtgits. If the string is fewer than 

lijiir ht^K dl^^its the result field contains the value right adiMsEed 
wlih l^*^<Un;'. i^f^roea- A saiaple prQ&r.sp Is provided at the ev.d of this 




Disassemble an Instruction 

TUf ^s.\\\r 11 Monitor contains a disassembler by ncana of wtkich one can 
<M!j|i[;iv n pifvrJon of n i.iachine languajje prosram in i^emonics inst*^^ 
<■! Inr.r hrx. M Inho! LIHT (SFi^l.'SK) is the routine to which oontx^, 
i^nMMi^d wlirn lU- Monitor comniand "L" is used. This routine sets 



CoimteT to 10, and then calls the single Instruction disaasemhler 20 

tl^es, "ith appropriate .Tdjustment of the Instruf^J^a^i 

:T3lis routine can be used a& an example of how to. ■^^^^r Ji^ii^fe^n^ i^- 

the address table id.th labels INSTDSP and 

The routine at INSTDSP uses ^he INSDSl routine to sot Llie zero page 
locations FORMAT and LENGTH appropriately for tbe instruction at 
<PCL,H). INSDSl ^\so prinCs to lIjg screen the contents of PCL,Ey .|i^- 
address of the instruction to be dlyasserabled. On return from Il^^fJ^.. 
the INSTDSP routine controls the printing of the rest of the 
disassembly 11 rn^, 

tfote thst PCL,H is not altered by di*; assembly of tbe instructitjn. 
^ ^l^sC be 'Wlntatned" hy the program which calls ItJSTDSP. 
'fe ^^tifflpllHhed by calling the PCADJ routine, which returns the 
txevr Values to the calling program, SteEft ins^*^^;*^ 'E^ttvife 
S-r^eg aiid Y-reg, respect iveJ y , havlt^ y^^ft^ 'il^ fe^^Jl^. 
and PCH and LKNCTH <set by INSDSD- 

ADDRESS TABLE 

Hex +l)ec -Dec ffonltor Res?isters 
Addr Addr Addr Label Destroyed 



643 S2 -1 184 MULPK i^,X,Y 



64355 -1181 nUL 

'mm 




OLD MONITOR OM.Y 
Multi ply signed fields leavinf^ 
sign in LSI? of SIG.^< 



fclEi;p;Ly fields mstgned. 



FB6 




Set absolute vslues for ACL^H and 
AUXL,H leaving resulting sign in 
LSB of SIGN {called by MULFM and 



AUTdSTABT MONITOR- ONLY 

Set validity of RESET vector. FB6F fi^.W -11^9 SEtpwrG A 



BOTH OLD AHD AUTOSTART MONITORS 

MonlLor Ccmraand Processor GO enury, FFRf> 652^*6 -330 GO 



Set PCL,H from AIL, If if entered- s 

Call RESTORE, set all rej^s but S-& FFB9 652^9 -327 
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Hex +Dec 
Addr Addr 



-Dec flonitor Registers 
Addr Label Destroyed 



Move bytes In memory to (AAL^ 
froTi CA1L,H) thru (A2L,I0- 
Hote; Y-reft must be zero on entry 




■Enci^eweii^ pointer A4L,H. 
IttFj^F-GBj^f^ ^^olnter AlLj.:^:^^t^ 



& F.qj(,4 4 



^^^VG refis A,X,f,P,S at 

?4's--S/,y, 

li.'sforr- b'"j02 re*^s A,X,V,P frora 



FFAA 65354 -182 SAVE 



A,X 



FF3F 65343 -193 RESTORE A,X,Y,p 



^loiivert hex characters from 





-WA7 65447 -S9 



GETHUM A,X,T 



fir 



In A.Y r<^gs ftir (PCL,H), 



APPLESOFT SAMPLE DATA MANIPULATION 




■m 

;^4tf 

m 



REM 
REM 

Rm 

mi 



$ + BFJl 

F<m r - 1 TO LFN (SI$) 

i:c4 - nius csis,i,i) 

r.r.l ASO CCC$) -f 128 

vtm: 'i^i^^i REM 

CAI.L, - 3:^7; Rl^I 

:>T ' v\\\-:k (62J + 256 * 

\\- y.T > 127^^ 'mm m,'^ 



rjATA riANIPULATION FUNCTIONS 
SA^tPLE PROGRAM 

r-m:iORy dump 

OF JIEX AREA INDICATED, 

REM BYPASS 
CALL GETMEi HOUTXNF. 
REfr PCL=SA7 

BUILD STRIMG TO i^Td 




REM 
REM 

REM 




14W KKTlfKM 



SET YRFG TO S^TART AT LOCATTOM 513 
CLEAR MODE BYTE 
W PROCESSOR 
PEEK (63): REM ST^START ADDRESS ( SA^ J. 



i — 





102(3 
1330 
104(3 

105^* 
1083 

1T390 
1100 
1110 

1120 
1130 




EETf DISPLAY HEX CONTKMTS 
./ 256 . CET HI JJJDRESS BYTE 




POKK 58,163 
POKE 59,253 
't^J'j. - 327 



SL% - < iiYz 4 4 

if m% THEN CALL -625 

POKE 71,0: REM SET "Y" REG TO ZEm 

RETl PCL = SA3 

REM PCJl - $Fn 
REM CLEAR "Y" REG & $FDa3G 

|- 36,29: PRINT "! : REM SEPARATES HEX FROM 

REM DISPLAY ASCII CtlARACTER CONTENTS 

^ + 7 - REM SEPARATES HEX FROM ASCII 

.1 = ST TO SE REM PRINT ASCII CONTENTS 

Ci - PEER W CX < 12S THEN = C ?C . + UP 



KEM PROGRAM START 
PRINT "KEX DISPLAY" 
INPUT "ENTER ADDRESS ";AD$ 
IF ADS = "END" THEN END 
TF LEN (ADSif - 



G0SI5B 2001 
FOR J = 1 

GOSUB 600 
ST = + # 
NEXT 

PRINT 
GOTO 10^3 




MONITOR COMMAND PROCESSOR 



The Monitor ComTnand Proci?ssor is that part of Che Monitor whlth 
iej;*M5tids to commands entered with the prompt character- Ihm^ 

^^y^^tids include data ooveirient from one location to another, c 
mm ■I^M^Tif' and siting, liiatlji&tioji disaseemblyj and oLhtJis 



manual describes calling S&M^f^ 
Instead of from the ke^boar 
return to the user proj*rara. 




ENTERING THE MONITOR COMMAND PROCESSOR 

The Monitor Coninacid Processor is that part of Che Tfonltft^ 
keyboard input wl ch the asterisk prompt character and perfortt- 
requested ^^ervlce- "Entering" the Coomand Processor implies t§|^ 
ov(?r control of the machine no the Monitor [lode. i^Jhen the 
pi-esscd with Che Old Monitor In Che Apple the computer Is plac^ 4tt 
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Monitor Mode. When the RESLT key is pre^jsed with the Autostart Monitor 
in the machine, Che computer generally goes Into BASIC or APPLESOFT. 



reading tlie conmiartae from tne keyboard and men acting upon tliem, 

Tliort? are a number of entry yioints indicated in Che address table for 
"entering" Che Monitor Command Processor- Please note that once the 

'lonitor Is ivimped to at the specified point, all <^ tga 
di'si ribed after that entry point is also perf ormeriii 

1 lu' "fn" at the end of each function description. 





CALLING THE MONITOR COMMAND PROCESSOR 

"C^illlnj*" Che Monitor Command Processor Implies that return will Cake 
place to the calling program, Houever, the driver part of the Honlcoc 
tlommarid Processor is not designed to operate in that fashion, so a 
Fjhorc machine language program is required to allow esit back to t^^_ 
1. ill In;* program* A sample program is provlde<3 at the end of thl^. 
rn'i i Eon indicating the required setup- ■Eft ^t50i ifliftp*^^^^ 
tii-irhlru- language routine is placed In |^^'"^t^ 
bi'. placed atv^whej^fir^desixed^ Witl> tiiie ^og^am-, '&£tifcor --x^iji^^ 

A pros*''*"! which CALLS the Command Processor must first store the three 

hyU' exit routlite somewhere- Then the program can POKE a string of 
M<ni1for commands Into the input area, beginning aC address S&^200, the 

I f.'.r ( Dinniand of each such string being a Monitor GO command to 

ri.iFi;,tL'i control to the exit routine. In the sample, the last Monitor 
I r>iiLirinn:l In the string is "02FCG"- The function of the exit routine is 

rh<^n m an ^ "fs t^iom ^E^^^#|;, (^^^ 

i n ! I I 111', iirogrf^m* 



AaDRE^ TABU. 



HeK +Dec -Dec Monitor Reglscers 
Acdr Addr Addr Label Destroyed 



rv ^xii'Tit used tov/'M*' 



Mtrnfmr Command ProcG^^S^fc '^j^tS 

t FNirid *-n t ry pnl nt . 

Mo ri f I or ( lommniTid Proc oJ^so r , Store 
I <-ti: ! nr . 

Moll I l<tr Command Processor, set 



"5" 



?E10B 65^35 -5fll STOP 



reiB 65348 -488 SETMODE A^.^ 



Hex +Bec -Dec Monitor Re^-^isters 
Addr Addr Addr Label Destroyed 



Store appropriate value 

entered froin BLANK also, 
tlonltor Command Processor routine 

for less than (<) command. 
Monitor Cprnmand Processor 110VE 

>^ at ever - 



^^^^ 




,ML,fr) tritu whatever 



■rences printed Chru COUT 
land Processor LIST 
(disassembler) routine; list 20 

instructions thru COUT* 
Set INVFLC to $3F =- inverse video. 
Set INVn_G to Sf''^' = normal video. 
Set INVFLG from Y-reg , 
Set port ^ (keyboard) fo]^'4^^?#> 

Set 'pp,r:t ^) .^p^^^^^p.^^ 

Set port (A) for output. 

Set port (A2L) for out.piit- 

jtonltor Command Processor GO eritry- 

pcL,H from k-n.^%M -^mm^--* s 

%At RESTORE, set ^ 
Jump via PCL,TU 
Monitor Command Processor Display 

Re^^ist er contonts . 
Monitor Command Processor Carriage 
Returii onrry. 

First, simulate entry of hlaifew 
Then POP 2 from stack and gt^&ip 
Monitor Command Processor at 
Restore registers from $A5-^9r 

Load STATUS and pUSti m S 

Load A Ixo^ ACC- 

Load X from XRRG. 

Load Y from YREG. 

\,0:\d P from stack (PLP) and RTS 
Save 65(^2 regs at $A5-A9. 

Save A-reg at ACC 

Save X-r^jg at KREG $46. 

Save Y-reg at YREG $47. 

Save P-reg at STATUS $48, 

Save S-reg at SPNT 549. 



FE20 


65056 


-480 


LT 


A.X 


FE2G 




-468 


MOVE 












1 ^ r > 














65152 


-384 


SETIHV 


Y 




U J 1 JV 


-J 




V 
L 


FEfi6 


65158 


-378 


SETIFLG 


noae 


FE89 


65161 


-375 


SRTKBH 


A,X,y 


FE8B 


55163 


-373 


IN PORT 




FE8D 


65165 


-371 


XNPRT 


A,X,Y 


FE93 


&5I71 


-365 


SETVTD 


A,X,Y 


FK95 


65173 


-363 


OUTPORT 


A,X,Y 


FE97 


65175 


-361 


OUTPRT 


A,X,Y 


FE1S6 


65206 


-330 


GO 


A,X,Y,P 


FEB 9 


55209 


-327 






FEBC 


65212 


-324 






FEBF 


65215 


-321 


RKGZ 




FEF6 


65270 


-266 


CRMON 





G 



FF42 
FF44 
FF46 

FF48 
FF4A 

FF4C 
FF4E 



65346 
65348 
65350 
65352 
65354 

65356 
65358 



-190 

-188 
■186 
-1 84 
-182 



.Clear 6502 decimal mode <set hex) 




RESTRl 



SAVE 



SAVl 



Monitor entry on 
o r Power on. 

Call SETNORM - wMte Oil black. 
Call IHIT - Text + full scroll, 
^ali SETVID - 

C 

Clear 6502 

Jrnm&nd Processor Entry 



Hex +Dec -Dec Monitor Registers 
Addt Addr Addr Label Destroyed 



:all S^ir^ 
ear 6532 '^pftdf ''i^iie 



FF5C 



Sot 



as prompt character- 



^ct (a) as prompt character. 

GRTLNZ to read command line- 
Cipjir MODE before scanning llne- 

Pi^k up one command: 
G«l 1 fiKTNITM to scan Input line, 

■^svlnR hex dibits in A2l,H, md 




iiKJCC command in the line^ if any. 

Monitor Command Processor command 
;jjirn[nj^ routine; save hex digits 
in A2L,h', return th command 
(iliKt i-Lon-hex) in A-reg, Y-^^e^^,■ 
Hi'l iff next character, 
(^a 1 1 routine Indicated by command 
Ghanicter: 
Pijrth address $FExx onto stack- 
I'jiHH (MODE) to called rou&ike ^St 

A-reg < 
CUrar mm before call. 
Cnll fielecned routine by RTS- 
Ch'jir MOTIF byte between, commands- 



FF6B 
FF6D 
FF70 

FF73 



I'FA7 



65387 
65389 
65392 




65372 -164 




-149 
-147 
-144 



FFC7 65479 -57 



ZMODE 



i; jn^ nr (■ I iiiit Miction at (PCL^K) , 
wH li d^Mp]ny of instruction and 
rcmil I rv}\ t st crs . 

^tijiilli^r rtjmmjind Processor TRACE 

InHrructlnns routine^ 
Moniri»r STEP One instructi^fi* 



All.jr 60,61 S3C,31J 

A2l.,n fr2,63 m.it 
^L^M- 

i^^a 



FA43 64067 -1469 STEP 



iP^2. 65218 -318 TRACE 



y^m^ -^m^ '-^m 



"7^ 





I REM MONITOR COMMAND PROCESSOR SAMPLE PROGRAM 
1^ AAS = "2FC;68 68 N 2FCG REM SET DP RETURN ROliTiRE 

II msm REtl MOVE COMMAND TO KEyBQAjtB W^IE J^^l. 



130 
140 

141 

150 

im 

1050 
1070 





REM RETtTRN IS SET. NQW C^,- 




GOSUB W^: REM -'SS 
PRINT : PRINT ; 
PRlfJT "THATS ALL. " 
END 

B = 511; REM FOR LOOP IS 1 TO LIM, SO B-EYTE BEFORE S200 

LIK - LEN <AA$) 
FOR I - 1 TO LIM 

PS = MID$ (AA5,I,li 

P - ASG 
POKE B I# 



f PEAKER USE THROUGH THE MONI7t$i 



There are many ways to iisa the speaker in thfi Apple II, One of these 
ways Is to signal pro^^ram events- The Monitor contains a routine which 

Gupports this use by toggling ^^^^^r--fle ^l.f^!- ^ ^^^n^i., 'W^^' 
l3 the "heep" heard whoa the RE^^ -5^. ^essr^ ^^j^r :^3Wpi^$.t^ 
tape record read or write - 



■!5EE*^^'^^le TI ^oes not contain ^^^^ fe--^^^^ 

''^^U^^.'W^I^ Attach to the Apple II mafce a ^lind 6f some type when 
^ ...... codft. On the Apple II keylioflEil this Is the 

^raeter code 13 $S7 or decimal 1.35- "Frintin.g" this 





If you ill^^^ '^^^urtd the bell in the A^ple regardless of 
output i^^S-i^^e, then dfrei:tly call the routine in tHe 
m^tm''^^ ^j*Tid,; -1059 (or CAU^ 6^^ii%, 

m^t^m ^"fcm^^i"fffr iG^'. tfe^A-.res and Y-ri^^'^ " 



T"rrA) = SB.' wait -01 s^" 




Mound i:hc "bell'\ Else, RTS. 

WjiU. .01 secon<fs> then sound hell- FBDD 

l,<-»d Y = 192 Tor ,1 sec of hdl, & FBE2 

I'oj'.r.l'' speLiker at 1 KHZ for number FBE4 
ikl i.yc in Y-reg» 
[■['ni thru COUT "ERR" and bell code,FF2D 

f ; liii hell code ($R7) thru COUT, FF3A 




' ^m^- '-'m il 



64477 "10^9 

64482 -1054 

64484 -1052 

65325 -211 

65338 -198 





A/t 






tiELL2 


A,Y 


PRERR 


A 


BELL 


A 



CASSETTE TAPE INPUT AND OUTPUT 

■^Jtii^is tWQ primary entry polntfi fft ^iiitor witli regard to 

ri'Mlng and writing tape. They are RP,A# fff^K, The requirements fo^ 
f^nllljij^ these 'a.r& described beJow. Th^i^ "^^xber of dther routine 

iTitrv ptifnts which are used by the Monlto't on hit and byte bijsis- TheRG 

ih'soribod below to the extent of location In the TTonitor and 

I nd i r,i r I rill of which Apple II programs call theni , but the precise 

r I III ! of instructions between consecutive calls is beyond the scope 

<'\ 1 h I s manua] • 



/■ji yim will have found by now, some t^jpe files are conposed of one 



, n>4^ ■BOiao Of two records. For example ""^fTO;^-^. .^S^^^PS^^ '^f^^ 
BASiq jijfe^^' l^.^sults in two beeps, ^i^nalir^^ ."^Cig^^r^''^^^'-" '"^^^ ''' 



.^^ mf^ fm^x'A i-s a single contiguoua mtfm m % 

Into or written from memory as a unit, A tape record Is a 
VH W'iil j^nLi ty - 

A I lie iin tape i^ a -series or sequence of one or more records 



nf ■^t-<KtfT -mm^*. When the Mim^ 1^": i^attflfied B-A..,. 
th^ fifp-i imi^^r mpTC uses the "^^fifeth indicaCed:"^ 

Ifi- iU-wmtti^- glf^Ut ajid End p^:^^' isi ^l^ory Into whij^^-^^fe '^iwin, 




rrti'T.inj^ ,?re also SAVEd as two record sets or files* Hnweuer, 

t li'* flir^l nrord [ ^- three hyt^s lonj^: the first two bytes indicate the 

hvi^Hu and I hi- tliE fd byte is set to $55 to indicate a normal APPLESOFT 

1,1 (%rt.:mf'f*r:*?Wt^.^'f 



Some other programs write a longer (buC fixed length) first record 
COnLalning length of the second record of the £ile, and other Infor- 



WRITE 



SFECD 65229 -307 



.f^^Qxe entry at tN^|^ ^get the first byte addreas-i* ^.^^ 

■3fe) ^araii the last Ij^r^e a^Tesa at A2T, , H ( Sr^P.-^?) . The Monitor will writft 

©l^^'^pS^Q^ e^^;45^^ t^ne (header) fotlc^ the cpntents of 

Tieraory aa' sp^^MeA-^ '^^sH^^d by ono byte i^tikc^am ^ttie xesalt of 

Exclusive ^.m m^. -wsm mm^m ^-■■^■■^j^;* 



READ 



S FEFD 65277 -^2^^ 

Before entry at this point, place the flrsf: byte -sddrcss into AlL,H 

<$3C-3D) ai^d the last byte address into A2L,H (53E-3F), The Monitor 
Teade the data from the tape, 
,3.ocat:ioiia , and iKiintaining. a 

l^e^e field *^lj_ed.. ClKS,Uf^"'"|^g^E|v '^^^^V" specified memory location 

iJ^-^^^Mi^r ^eads one iriore byte and 

M mp^la Monitor aounds a 




Tf you want to hav*? the calling program determine whether the tape w^s 
read si^ccessf ly or not, then some .'special actions ifiust he Lcik(?n, One 
method is to compare the contents of ClT C$2i) before the tape read with 
the contents after* If they are egual^ KR"? waB not printed to the 

screen. If the cursior horizontal position (CK) has changed across the 
tcall to READ, then ERK must have been written to the screen. If fhiiS 
Condition Is encountered, the prograra can then ask th*^ operator 

:;goaltion the tape and signal the program for anot^^ex attenjpt at ^S^^t^ 
^^i^. |€cord. Caution: U ^kj^l^ ^^k^ ^rM^v^. 
iEotffc^He whluh does not na^f^': lioi ^^a^i^fi^i^i^e^?! -'S ■SsS^j 



WmSm \HPiivoumi internal routines 

■-^ mmmm -^^m-'-'f^^^^^m functions are d^^^m^ .^.-m 

:4e^^^^ea ifi -^^^tE^^^ totail ■Bm call by user pr-c^^m;^" mm 



HEADR 



Thfji routine writes the synchronization laonotone which ia the first 
pAvt of every tape record- When the WRITE routine calls IIEA-TJR, it 
ri $^(^ inte thQ'.-A-^r-^ ^(ms'ii^ a f^xm^d "header ta. be wnitteo* .Tte SEA 

^■^■^ f.-ti"^ ^GEbre calling HEALR so the 
?i W^l^out 3,5 seconds. This mutlne 
pi^^j^^^ fee it Js vsed liy Jhe Programnter s 



delay for l.^^-rawct?^ 



E 



■■"i 




^^ KCt'A 6^4762 -774 

Thtn roti.clJ^^ c^vi^ee looping with decrementing of the Y-reg irntll the 
T^^^^^grS^^^ "l^^^^ two transitions of the tape input register. The 
mroW Iti^^' tli ^%ed twice for this purpose. Contents of the reg 

rt^^r-M^^^^^gi mn^v^m mymm '^1.*^ m m^^i.m 

It tod tte -mm^^im^^^ 



TU\h routine is called from within the Monitor by the R?M routine, to 
di'l.iv entering data transEer .iiode until tape input is available, READ 
i-jiWa llEAUli! for the 3,5 secor^d delay on return from Its call to RD2BIT- 



-771 



ThfH rcniliatc ii^^p,^. ^th decrementing of the Y-reg while testing the 
l.*ipo Input E;^^^3?ter far transition from zero to one or one to aero<. 
vjiluf f>f -0^0 it^ then determined from the resliiual couat in 




ihir* ront I ni* rallf! R!)2B1T ae required in order to assemble a by.t;^^ of 
tnt'Opma't I'on from the tape- It then returns to caller witJi the "^fe* 
fJ^=J^tr^^* In addition to being called from the Monitor READ t^^^t^^ 
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write ten bits tc the tape. The only caller is WRITK in the flunltor- 



PADDLES, BUTTONS & ANNUNCIATOR I/O 

The Apple 11 ha<i a Gane 1/0 connector with hardware support for four 

digital outputs, three digitiil Iriputs, and four mialog iripntEj (called 

paddles). The Monitor re^ids the p£iddles by wiiLing a strobe to start 
the poddle timer and then readin;* the selected paddle tinier and 

incrementing the Y'-rej* until that timer comes true. The result of the 

read is in the Y-reg - Monitor support fur digital outputs or digit 

■iopMts 1e not required- Access Co the digital I/O ports i,s gained by 

i^Mfe;ii^#ge used, Thfe Autostart J^tonitof iJoe& iTiltlallse ih& 
digital output ports (annunciators) oti any RESET key interrupt- ANtfl 
and AKl are initialized to the clear (TTL W) condition by reference 
to addresses SC0^S and SC^5A- AJJ2 and AN3 are Initialized to the set 
<TTL HI) condition by reference to addresses and SCt&5¥ . 



nee the Monitor support to read the setting at a paddle, JSR to 



t;£»jPPle n(.mber (eS-3> in X-re^ , art|; 

^iaSM©-«dll be found in the Y-reg , ^j^-rx?^^ & ^fel^IC^e^ ^-"-i*^" 



Direct reading of the pa<3idles -nay he iiccomplish^d by accessing the 
paddle tripgcr to stajrt all paddle timers and then reading the 
appropriate paddle input address repeatedly while counting until Che 

value read from the paddle address no Jon^er has the $80 bit set. 

CAUTION; After reading a paddle, let some tima go by before reading 

another paddle or incorrect results ruay be a piroblein- Vi'hen the paddle 
trii^ger is strobed, all the timers scart< If the first paddle you 

read has a low value, on going back quickly to read another paddle 

fe^^ transition you see niay be f:^;^ ^ke ^^fc^^ e^^I;^ '±^^^^Se« 
the second. See the samjile 00^m^ ^ 1^. . _ . _ 



GAME I/O HARDWARE ADDRESS TABLE 



Hex +Dec -Dec 
Addr Addr Addr 




Paddle y switch 

Paddle 1 switch 
Paddle 2 switch 



Clear 
Set 

Clear 

Stt 
Clear 

Clear 
Set 



Amunclator 
Annunciator 
Annunciator 

Annunciator 
AnnunciaLor 



Annunciafor 
Annunciator 



output 
output 

1 output 

1 output 

2 output 

3 output, 
3 output - 




C0bl 

C063 

C05S 
C059 
C05A 

C05B 
C05C 




A925Z 



-mm 




A9249 

49250 
49351 

4924^ 
49241 
492^2 

49243 
49244 
^245 



-162S7 

-162a6 
-1 6285 

-16296 
-16295 
-16294 

-16293 
-1 6292 
-1 6291 
-16290 




Negative 

indicates 
button pushed 

POKE/STore 
zero 




WAIT ROUTINE 



The WAIT routine consists of a loop within a loop ^ constructed in 
such a maimer that the length of time spent In the loop varies 
geometrically with the entry A-re^ . A call to this routine wl 11 
a loop for a predictable l^eii^th of tiiae, such as is used by the 
tlonltorwlth re^Qi^ds to. mm -^f K^^^-*- "^^M^^^^ 

usable, for example, ir]^^^^^fj^ 'Mm, i^mim 

mt ^. i;^pm^um^^ 





Anaylsls of the code iTidicates that the time between the caJ^ 




An alternative formula is 

TZHF, [N MICROSI-XaNDS = (2 , 5 * Ct&*^-J'--.?ttviE 
where A = contents of accumulator 



mW ROUTINE DELAY TIMES 



A-ri±i! Ti^ie in 
(Dec • ) sec ondji 



A-re'i Time in 



(Dec. > 



A-res Time in 
(Dec , ) seconds 



1^ 



1 
7 

8 
9 

17 

18 

19 

2^ 
26 

31 



m 



'8 




><30^3447S1 

-00098719^ 
ll9R9'i6 



1956999 




49 
53 



55 

56 
57 
58 



73 

74 
75 

85 



91 
135 



.0(^683(^571 137 
.(^^7^97574 13S 




,014650383 

.015040146 
.015435(^24 

.019665129 
^^23116272 

.^24909^27 
,025416435 

.029G59839 
.*03^213282 



^3976401 




1 



195 
196 

204 
205 

218 
219 

239 
240 



-04990/055. 
-05362417& 





.109263561 
-110323389 

. I3456661S 
-125598056 

. 14940^965 
-150639819 



USE OF CONTROL Y WITl WmMETiW 



lii the APPLESOFT manual there is a caution that If one paddle la 
aiiottu!r should not be read toQ qulcklir. Fbllowing la a mac-hl-ne 




Inlcidte this pro^ran hy eiiterinj* the Tlonltoc command sxxxY^ where 
>:>:x:^ is a mimber representing the amount of delay to use between 
reading paddle and reading paddle ly and Y representfi con^ar.t^l-Y . 




PADDLE INTERFERENCE-SAMPLE PROGRAM 




2000 LDA StfC0 



200C 
200E 
2010 
2ffl2 

2014 

2016 
2019 

201B 
20 ID 

20 IF 

2021 



202A 
203C 
2ff2F 

2031 
2034 
2036 
^039 



2tT4A 
204c 
204f: 
2050 
2052 



LDA 
STA 
LDA 
STA 
LDX 

JSR 

STY 

DKC 
BNK 
lEC 
BMl 



LDA 
JSR 
Lt)A 
JSR 
7. DA 
JSR 

JSR 





2WA STA $11 



S1&* 
?12 

Sll 
SI 3 

Si2 

S201B 

$13 

S2^1B 



2023 LDX 5#1 

2025 JSR SFBIE 
2028 STY $1 



$FDDA 
3yM0 

SFDED 

SI 

$?DDA 
?F948. 





§29JG 


INC 


$4 


BNE 


S200C 


L3A 
^ 


S^^0 




m 


BKE 




INC 




H"NE 


S204^ 


JSR 


&FC58 







-^ck-'^ -^^'^^^^ from All. 



use. 



t:clt vjp Tiigli part of" entered count from Alft 
and store It for repeated 

t'ick up Iqw part of count; 



Set X for p.gddle read - 

Call paddle read - 

Store paddle result tn location 

Count down delay loop low byte: 
when zero, count down high byte. 

Stay in the loop until high goes minus 



Set X for paddle f re; 
Call padd ] e read - 
Store paddle 1 result in 

Pick up paddle value- 
Print it as a 
PI ck up a blanic 

Print the blank - 
Pick up paddle 1 va. 
Print it as a heit valqe?*. 
E^^^ ^ree bUTiks. 



■■"mt au-hile to keep v^&t^^ \ r%"^ 
from upsetting paddle results. 

Is it time to clear screen and restart? 
HE means no ^ go back and sampl e again.- 

Wair. a while before clearing, screen. 



i^ore Che per screeji counter, 
'■m^ go one more big rouna. 
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REGISTERS FOR BASIC MONITOR CALLS 



Many of the entry points specified ixi this book require presetting of 

registers for prope-i^ ^;Q{i©^.ti43E* . i& a- s^o^le .^^oj 

written for APPLESi)!^^/'^.^^ ^.^^ f^^^^^^^^^il 

dEtcimal to hex. 



The theory behind the operation is that on a Monitor G command, the 
registers are loaded ftora the SAVE area before going to the location 
specified in PCL,H. Thus, by poking destination addCeps inro PCL.H 
.^O.d the ref^uired register contents into XREG, IffiEG, an entry point In 





13 

m 

110 
150 



350 



REM CONVERT DKCIKAL 
INPUT "R^JTUR NUMBER 
IF A=99999 THEN ENU 
C% = A / 256 
POKE 71, QZ 

■fz -■.^^ 

POKE l^ySZ 
POKE 59, 9. 
POKE 58,6% 
PRINT 

CALL 65; 

mm. 




INPUT TO IIEX OUTPUT 
";A Read the Input - 

Provide a way to end the 
the high byte- 
for PRFTYX i^all. 





t pen t£j $F9, 
Set PCL to $40, 
Print a blank line* 
Entry point in GO pri 
Print a blank line* 



STEP AND TRACE PECULIARITIES 



The Step and Trace fnnotlons in the Old Monitor Incorrectly display 

register contents under some circumstances. The STEP routine detects 

and gives special attention to JRR^ RTS , .TMP, JMP indirect, RTI, and 

BRK Instructions- In each case, the register contents are displayed 
from the SAVE area at $45-^9, However, th^re is no SAVE call after 

"execution^' of these instructions, as there 13 for .m^f^ 

Instructions, so the registers displayed are those pr^;*^ftl 'jEt feji^ 
SAVE area before execution of this instruction, 

pverefore, on JSR and RTS, the displayed contents of the S-reg ace 
^iineo^t^j^i On the first Instruction atteT: a JSR or RTS, the S-teg 
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Tbe Step and Trace routines are not Incorrect in handling of ^ BR*? 

Instruction- That is, the address displayed fnr th^ ^9t-l^S ^fi^K^^tJii^., 
instead of beln^ off by two bytes, because the BRK 
STEP routine instead of being executed by the 6502. 




Althoujih step and trace can be very helpful for some program 

they c^nn?^ 



dehvvgglng tasks, they cannot he vised In tracing ca^H^ .^^^ Ttariltcjr 




1 
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